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VNC can be used on your Pi in two ways: 


@ If the Raspberry Pi is connected to a monitor or TV and is running a graphical desktop, you 
can see exactly what a user sitting in front of the Pi would see; perfect for generic remote 
access or sharing a screen with a friend! 
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VNC Viewer VNC Server 


If your Pi is headless or not running a graphical desktop, then graphical remote access can 
still be achieved by using VNC to create a virtual desktop instead; ideal for users who have 
built their Pi into a robot. 
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t’s hard to believe, but this is already 

our third new-look issue! The level of 

support the magazine is receiving from the 
Raspberry Pi and wider technology communities 
has been utterly fantastic. Believe it or not, The 
MagPi is one of the most popular technology 
magazines on the market today - it’s seriously 
exciting stuff! 
Of course, it doesn’t hurt that the Raspberry 
Pi has sold more than five million units since SUPER = 
its release in 2012, meaning it’s already one Find out which desktop distro deserves a place oF 
of the most successful British computers ever 
made. With the advent of the Raspberry Pi 2 and 
Windows 10 IoT support from Microsoft, there’s 
every possibility another five million will be sold 
in the next year or so alone. That makes for a truly 
massive community! 
Before I leave you to dig into the news, features 
and tutorials we have in store for you this issue, 
>d like to remind you that you can buy this and 
the other new-look MagPi issues in the App Store 
or on Google Play — just click on the little buttons : 
at the bottom of the page. Some of you have THIS MONTH: 
been asking why we sell the magazine digitally 
when the content is released under a Creative 08 PI 2 WINNERS ANNOUNCED 


Commons licence, but the answer is simple: Are you one of the lucky five from issue 31's competition? 


it?s an easy and convenient way for MagPi 36 HACK THE RASPBIAN DESKTOP 


readers and Pi enthusiasts to support the 
magazine and the Raspberry Pi Foundation. It Simon Long shows us how to make changes to LXPanel 


also means you can enjoy the magazine on your 06 IAN LIVINGSTONE & MICRO BIT 


favourite Apple and Android devices with all Sicenaieant “ Welchan 1 aeGnrsnd fa 
the mod cons like automated uploads, speedy Poe es ene nen ere eee a bene etngne oer rarer 


rendering, and clickable links! 14 THE BEST DESKTOPS GO ON TEST 


Russell Barnes It's just a feature. Let's be friends. Nobody has to get hurt. Aarrgh! 
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As the BBC looks to complement the Raspberry Pi with an entry-level 
programmable device called the Micro Bit, we talk to its advisor Ian 
Livingstone about the importance of coding... 


6 


igital creativity is in 

the spotlight like never 
before. The Raspberry 

Pi has opened up computing in 

a way not seen since the 1980s, 
Minecraft has shown that gaming 
is as much about creation as it is 
consuming, and there are Code 
Clubs being set up in towns and 
cities everywhere to get children 
‘under the bonnet’ of machines 


Year 7 comprises children aged 11 and 12, but 
should this initiative not be aimed even younger? 
“Ideally you want to get all children of all ages in 
primary schools learning the basics of computer 
science as a discipline of problem solving, 


computational thinking, algorithmic thinking, and 
logic, but if you are going to give each one of them 
a device, you need to take some responsibility and 
ensure it's not a wasted opportunity. | think 11 and 
12 is the right age,” says lan Livingstone. 
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and see just how they tick. 
Stepping into this scenario is 
the BBC, which has recently 
launched a UK-wide initiative 
called ‘Make It Digital’ to inspire 
a new generation to get creative 
with coding, programming, and 
technology. At its centre is anew 
coding device being given to every 
child in year 7 — a million units 
in total. It is being nicknamed 
the Micro Bit, harking back to the 
days of the BBC Micro. But while 
that name is subject to change, 
the idea behind it is not. 

The Micro Bit is a tiny, 
wearable device with a display 
of 25 embedded LEDs. It has a 
single micro-USB connector, 
low-power Bluetooth, digital and 
analogue I/O, an accelerometer, 
and magnetometer. Children are 
able to program simple messages 
or animation and even connect it 
to a Pi. It has been designed to be 


introductory, complementing the 
strides made by the Raspberry Pi 
rather than competing with it. 

“Raspberry Pi has worked with 
the BBC on the Micro Bit,” says 
Ian Livingstone, veteran games 
designer and advisor for Make 
It Digital. “It’s an entry-level 
device produced in collaboration 
with many partners and it’s 
about getting people through 
the funnel of technology. I fully 
support the Pi because it’s a 
fantastic tool to enable creativity 
to be manifested, whether it’s 
though building a website, doing 
some robotics, making an app, or 
building a game.” 

Key to Make It Digital - which 
will be backed by a season of TV 
programmes and online activity 
involving top BBC shows such 
as Doctor Who and Eastenders — 
is the desire to recapture the 
spirit of coding. Ian Livingstone 
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laments that the UK has “lost a 
generation” - “I just think it’s 

a great shame that [from] the 
mid-80s until last year, children 
have been taught how to use 
technology but given no means to 
create their own” - but he hopes 
the Micro Bit, as well as the Pi, 
will go some way to turning 
things around. 

The big problem, he argues, is 
that while some schools did teach 
computer science and coding, 
it wasn’t mandatory. Most ICT 
teachers, he adds, just taught the 
curriculum as it was, teaching 
digital literacy without any digital 
making. Fortunately, that has 
changed. The new computing 


I fully support the P1 because 
it's a fantastic tool to enable 
creativity to be manifested 


curriculum introduced last 

September marked a fundamental 
shift towards coding. And while it 
sparked some nervousness among 
teachers, Ilan makes no apologies. 

“This can be transformational 
for the country, but it does 
come with challenges about 
how well equipped the teachers 
are to teach computing science, 
and coding in particular,” Ian 
explains. “A lot of them aren’t, 
but that’s not a reason not to 
do it. You just have to accept 
that there is always going to 
be some child in the class who 
knows more than the teacher. So 
teachers should learn alongside 
the children and there should 
not be any problems with egos 
here. The teachers can facilitate 
a joint learning experience where 
they learn alongside children 
naturally, collaborating with 
peer-to-peer learning.” 

The Micro Bit, he says, is part 
of the solution, helping teachers, 
parents and pupils to adjust and 
learn. He believes it will bea 
great enabler of digital creativity 
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MAKING IT HAPPEN 


and he draws parallels with the 
BBC Micro’s record of helping to 
give rise to the games industry. 
His big hope is that the Micro 
Bit will encourage children to 
code when they may not have 
otherwise done so. “A lot of them 
may be thrown into the river, hit 
with a hammer, or sold on eBay, 
but I think the net output of 
giving one away to every child will 
be hugely positive,” he asserts. 
According to the BBC, the 
Micro Bit is all about encouraging 
independent learning among 
pupils. It wants teachers, parents, 
and children to watch out for ‘ 
supportive programming on the yy 
CBBC channel and to head to its e 


WHOIS IAN LIVINGSTONE? 


He is an advisor for Micro Bit, but what about his 
technology industry background? 

lan Livingstone is a founding father of the UK 
games industry. He co-founded Games Workshop 
in 1975, wrote many titles in the Fighting Fantasy 


book series, and launched global gaming franchises 
including Tomb Raider. He also co-wrote The 
Livingstone-Hope Skills Review, a Next Gen report 
published by Nesta in 2011 which set out how the 
UK could transform into a leading talent hub for the 
videogames and visual effects industries. 


website for live BBC Learning 
lessons and other educational 
content. The shows will hark 
back to the likes of The Computer 
Programme, which ran for ten 
episodes on BBC 2 in 1982. 

“The Micro Bit is for children, 
but clearly teachers and parents 
need to understand how to use it,” 
notes Ian. “The algorithm is just 
a set of instructions to this little 
device and you can type in code 
to make it do simplistic robotics. 
It’s entry-level stuff, but it’s part 
of the journey and the important 
thing is learning by doing. You 
can’t learn computer science from 
a textbook, just like you can’t learn 
to speak a foreign language by 
memorising 50,000 words. Children 
need to speak the language of 
code and engage with it. Minecraft 
and LittleBigPlanet have paved the 
way, showing that you’re not just 
a passive recipient of content, but 
can actually manipulate it and make 
it do something. With the Micro Bit 
and the Raspberry Pi, you can create 
your own games. It’s the next step 
on the path.” 


The report had been commissioned by Ed Vaizey, 
the Minister for Culture, Communications and the 
Creative Industries, and it stressed the importance 
of placing computer science on the curriculum 
as an essential discipline. Civil servants within the 
Department for Education were initially reluctant to 


take the recommendations on board. “But we got 

to Michael Gove's special advisors and the penny 
dropped,” says lan Livingstone. “We convinced the 
Secretary of State and his team. The new Computing 
curriculum was launched last September.” 


Above The BBC Micro 
played a big part in the 
1980s coding boom 
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FEATURE 


WHAT WOULD 
YOU DO WITHA 
RASPBERRY PI 2? 


Back in issue 31 we asked what you’d do if given a shiny Raspberry Pi 2 to play with. 
This issue we’re rewarding our top five favourite ideas, thanks to Pimoroni.com... 


Below We offered 
five Raspberry Pi 2s 
in issue 31 for your 
project ideas. We 
were inundated 
with entries 


e relaunched The MagPi 

soon after the Raspberry 

Pi 2 was released, so we 
knew immediately that we had 
to give a few away. We spoke to 
our friends at shop.pimoroni. 
com and they kindly agreed to 
sponsor us, offering to give away 
five Raspberry Pi 2s and a Pibow or 
Coupé case of the winner’s choice. 


Terms & Conditions 


Pi 2s 
must be 


WON! 


WHAT WOULD 
YOU DO WITH A 
RASPBERRY PI 2? 


Let us know for your chance to win! 


How to enter: 
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Our question, in case you need 
reminding, was simple: what 
would you do with a Raspberry 
Pi 2? The response was fantastic: 
hundreds and hundreds of you 
got in touch with some brilliant, 
intelligent, wacky, and downright 
stupid ideas; we’ve laid out 
our winners here. While the 
competition is over, we still want 
to know what you’re doing with 
your Pi. Let us know about your 
innovative hacks and projects via 
magpi@raspberrypi.org, or turn 
to page 64 and take part in this 
month’s competition to win a 
Raspberry Pi robot courtesy of our 
friends at PiBorg.org. 


Office 
server 
Long-time Linux 
user Aris Tsitras 
is going to create 
an office server with the Pi 2, 
since it fits the needs of his small 
office environment. “The 
Raspberry Pi is perfect for 
business as well as for pleasure. 
My office consists of ten people 
and to have a fully fledged server 
to handle email, webpages, 

PBX and DNS would be just too 


much.” A Raspberry Pi 2 or two — 
assuming you have a sufficiently 
small load — would do the job just 
as effectively, but considerably 
more efficiently. “As for 
pleasure, we have a media 
centre setup to chill during 
our breaks.” 

We’ re looking forward to seeing 
how the Raspberry Pi 2 performs 
in its office job! 


Custom 
media 
centre 

Guido Erlinger of 
Germany told us 
he’s going to use his Raspberry Pi 2 
to make a specially adapted media 
centre player for his physically and 
mentally disabled son. While he 
has plenty of media at his disposal 
(around 250 movies on DVD no 
less), his son is unable to change 
DVDs by himself. 

“The aim of the project would 
be to use a small system that 
consumes little power. The 
challenge will be to create an 
application which presents all the 
category pictures and the DVD 
cover images, so he can easily 
choose an DVD.” 
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WHAT WOULD YOU DO WITH A RASPBERRY PI 2? 


Left As well 

as receivinga 
Raspberry Pi 2, the 
winning entrants 
have also bagged 
a Pimoroni Pibow 


Media centres are already 
one of the most popular 
uses for the Raspberry 

Pi outside hacking, so 


Erlinger’s son will likely 
find some independence 
with one of the many 
solutions like Kodi or 
OpenELEC, not least when 
you consider that - once the 
movies are backed up on an 
external hard drive - it’s 
trivial to navigate movies, 
music and pictures, using a 
modern HDMI TV’s remote control. 


Animatronic 
scarecrow 
“T would use a 
Raspberry Pi 2 
to control an 
animatronic scarecrow to make 
with my son,” explains Richard 
Mitchell, a graphic designer 

at Brunel University London. 
While robotics is one of the most 
popular hands-on activities with 
the Raspberry Pi’s versatile GPIO 
pins, we’ve never encountered 
an animatronic scarecrow 
before, especially one designed 
to interact with passers-by and 
tell them jokes (something we’re 
pleased to remedy). 

Its get better, though: “It would 
be made of lots of seagulls hidden 
inside a big coat, which opens up 
to reveal them at the end.” Why? 
“Because gulls need to scare crows 
so they can get more chips.” 

Richard and his son plan to 
enter it into the annual Hayling 
Island Scarecrow Competition 
(bit.ly/1J9p50p) and we can’t wait 
to see how it fares! 


Fly 

Fishing 
“The Raspberry 
Pi project ’m 
working on is 
designed to help fly fishermen 
in Norway evaluate the fishing 
conditions in the Rena river 
without having to be there,” 
starts Peter Davidse. 


a. 
ie 
ied 
a] 
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Media centres are already one of the 
most popular uses for the Raspberry 
Pi outside hacking 


“The Pi will be measuring 
rainfall, air pressure, wind 
speed, wind direction, water 
temperature, water flow, water 
level, and air temperature. All 
the data will be presented on 
a webpage for PC and mobile 
devices, and as an excerpt sent 
by mail.” 

Peter goes on to explain that 
he may later add a camera to 
monitor a stretch of river, so he’d 
better watch out for our guide 
on how to do just that with the 
Raspberry Pi Camera Module in 
an upcoming issue. It’s surprising 
just how easy it is to set up. 

If you would like to get started 
with ‘physical computing’ 
(basically, sensing the real word 
with technology) on a slightly 
smaller and more affordable 
scale, check out our five-star 
review of the latest CamJam 
EduKit on page 59. 


Retro 
gaming 
cabinet 

Andy Jackson’s 
planned project 
revolves around retro gaming: 

“My dream Raspberry Pi project is 
to firstly make a custom cocktail 
cabinet with arcade controls for my 
daughter, so she will be able to play 
old-school arcade games.” Well, 
that dream just got one step closer 
to reality! 

Given that Andy’s daughter Faye 
is only just about to turn one, we 
have a sneaking suspicion it’ll be 
Andy tapping away at retro classics 
for a while yet! 

“As she gets older, I want to use 
the Pi to teach her how computers 
work, and show her what her daddy 
does for a living (hopefully, doing 
my part to get the next generation 
of girls into IT).” 
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FEATURE 


TEACHING THE TEACHERS 


The Picademy initiative has just had its first birthday. To celebrate, we caught up with 
its creator and former teacher, Carrie Anne Philbin, to find out more about how the 
project helps educators to teach computing in schools... 
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The Raspberry Picademy is a free professional 
development experience for primary and secondary 
teachers, open to individuals around the world. 
Over the course of two days, 24 teachers get 
hands-on with computing, and discover the many 
ways in which the Raspberry Pi can be used in 

the classroom. No experience is necessary; the 
Foundation's Education Team 

will help you discover 
practical ways in 
which Raspberry 

Pi can support 

and further your 


F, 


teaching of the A a aN 


new curriculum. 
Learn more and 
apply today at: 
raspberrypi.org/ 
picademy 


PICADEMY 


MiégPi: May 2015 


hen the new creative- 

focused Computing 

curriculum was announced 
for September last year, it sought 
to unlock the secrets hidden 
behind a myriad glossy operating 
systems and empower pupils to 
learn about more than just Word, 
PowerPoint, and Excel. 

But there was a small problem. 
Some teachers were too poorly 
equipped to teach the new subject 
and feared their skills gap would be 
exposed for their pupils to see. Yet, 
thanks to a free two-day course for 
primary and secondary teachers 
called Picademy, many of them 
have grown in confidence. 

Picademy is the brainchild of 
Carrie Anne Philbin, a former East 
London Computing and ICT teacher 
who left to take on the role of 
education pioneer at the Raspberry 


Pi Foundation. She got the idea 
for Picademy after attending the 
2014 BETT Show, a huge education 
exhibition in London, and noting 
the changing attitudes among 
teachers. The initiative has 
now been running for the past 
year, during which time it has 
supported 200 teachers. 

“Pd attended in 2013 when 
I was still a teacher... I was 
hanging around the Pi guys and 
the OCR stand, and all of the 
questions they were fielding 
concerned the reasons for 
using the Raspberry Pi in the 
classroom,” she tells us. “In 
2014, it was very different. 
Teachers were asking about our 
teaching materials and they 
were convinced the Pi would 
help them. One thing that struck 
me over the four days was the 
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Carrie Anne (Philbin 
is also the author of 
Wiley's Adventures 
in Raspberry Pi 


number of people asking when 
we would launch a teacher 
training programme.” 

The first Picademy ran on 14 
and 15 April in 2014, and Carrie 
Anne had set down some rules 
about who would make up the 
class of 24. She wanted half of 
the teachers to be from a primary 
school and the other half from 
a secondary school. A further 
four places would be handed 
to teachers working in other 
countries. Everyone was asked to 
fill in an application form. 


Smooth operation 

Carrie Anne also had a clear idea 
of how she wanted the Picademy 
class to operate. “It was always 
going to be over two days — one 
for the workshop and one that 
allowed teachers to really make it 
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their own and get something from 
it,” she reveals. “We wanted to 
have it in Cambridge, too, because 
it was easy for us to do. We hada 
new office in a larger space, and 
access to kit and people, so it kind 
of made sense. But above all, we 
wanted to create the best possible 
environment so that we could 
inspire teachers a little bit more, 
get them started with Pi, and build 
confidence around computing and 
computer science in general.” 
Giving teachers the confidence 
to approach teaching in a new way 
has been one of the most crucial 
aspects of the Picademy. “A lot 
of teachers would say they were 
getting started and they were not 
afraid to have a go, but they did 
worry that pupils were already 
ahead of them and they wanted to 
know how to stay one step ahead,” 
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So far, Picademy has attracted educators from the 
USA, the Czech Republic, Lebanon, and Portugal. 
But Estonian teachers appear to be taking most 
interest. “Estonian teachers are coming on our 


courses because Estonia is doing what we are doing 
- getting children interested in computing,” says 
Carrie Anne Philbin. “A Lot of people in Europe are 
watching what we are doing. It’s very exciting.” 
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Carrie Anne explains. “We looked 
to change that thinking and say it’s 
okay for students to be ahead. It’s 
about how you deal with that as a 
teacher. For us, it’s about creating 
a community of teachers who can 
talk and support each other.” 


workshops that introduce teachers 
to many aspects of physical 
computing — including Scratch, 
Python, Pi Camera, Sonic Pi, and 
Minecraft Pi — and by engaging 
teachers in fun activities, they are 
able to see how computing can 


We warn teachers that we will blow 
their mind with a lot of information, 
but tell them that it is worth it 


The sessions are tailored to 
facilitate this. The first days are 
“full of stuff and in your face,” 
says Carrie Anne. “We warn 
teachers that we will blow their 
mind with a lot of information, 
but tell them that it is worth it.” 
The day involves back-to-back 


“Picademy allowed me to gain a great network 

of educators, from across the age ranges, who 

can inspire and support me. | gained confidence 

in my own computing abilities, recognising what | 
could already do, as well as learning new skills and 
knowledge. | also gained an understanding of the 
variety of activities and approaches that could be 
used. Seeing several people in one room given the 
same resources but creating their own thing isa 
fantastic way to demonstrate creativity.” 


Sway Grantham, primary computing teacher 
and Raspberry Pi certified educator 
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be cross-curricular. At the end of 
the first day is a brainstorming 
session, jotted down on a series 

of sticky notes, which looks at the 
projects the teachers would like 

to work on and take back to the 
classroom. This continues into the 
evening over dinner. 


“They are exhausted by this 
point, so we go for a meal, which 
is nice because it keeps the 
conversation going,” confides 
Carrie Anne. “It gears them up for 
the following day, which starts with 
Eben [Upton] talking about the 
history of the Pi, what we’re doing, 
and where we’re going. We also 
have talks from the community. It’s 
important teachers realise there is a 
good community to tap into.” 

By mid-morning on the second 
day, the teams look back at the 
sticky notes, break into groups, 
and make something of their own. 
They present their findings to the 
group, get a badge and certificate, 
and are sent on their way. “The 
second day is what everyone raves 
about,” says Carrie Anne. “Often 
we can’t get rid of people — they 
want to live here.” 


ve There's a lot to cram into the training, and teachers go hands-on with Pi projects 
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Mixed abilities 


So far there have been seven 
Picademy sessions and they have 
attracted a wide range of specialist 
teachers, from computer science 
to music and art. “We even hada 
history teacher,” Carrie Anne adds. 
As such, each session has hada 
mixed range of abilities. “We have 
had experts in computer science 
and people with no programming 
experience whatsoever, but it’s 
allowed us to demonstrate that 
computer science can underpin 
a lot of other subjects. By 
personalising the sessions for each 
teacher, we ensure they take away 
something useful to them and 
their classes.” 

Not everyone has stayed the 
course. Although the sessions 
are always oversubscribed, some 
teachers do drop out. In the first 
four Picademies, some left after 
the first day. “I think some have an 
assumption that all of the answers 
will be handed to them, but it’s 
not about that,” she insists. “It’s 
about encouraging teachers to find 
answers themselves and it’s about 
getting an idea of computer science 
as a problem solver. It’s perhaps 
not for everyone.” Even so, the 
team says it learns from feedback. 
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It has introduced robotics to the 
workshops and it now allows 
teachers to take away the provided 
SD cards. Outsiders including 
Martin O’Hanlon are contracted to 
help with sessions, too. 

The Picademy has been such 
a success that the Raspberry 
Pi Foundation is thinking of 
expanding it. Last November, a 
course ran for Welsh teachers 
in Wales and, on 26 and 27 May 
this year, the Picademy North 
is running at the National STEM 
Centre in York. Carrie Anne is 
thinking of creating another in 
the south-west of England. There 
is every chance that there will be 
Picademies in towns and cities 
across the UK in the future. 

“We are looking to scale it [up],” 
she discloses. “But we do have a 
problem because we are a small 
educational team working with 
each other in one building. If we 
put on a Picademy in a bunch of 
cities, we’d have to contract it 
out and there could be a drop-off 
in quality. We’d have to rebrand 
it, create a Picademy X, because | 
would be concerned with branding, 
but it’s something we are 
considering and would do if we got 
the franchise model right and the 


appropriate team. We’ll see how 
Picademy North goes.” 

One thing is for certain: Picademy 
fills a hole. “The government 
invested £3 million in the re-skilling 
of teachers, but that only works out 
as £170 per school, which doesn’t 
cover a teacher for a day,” says 
Carrie Anne. “Our course is free, 
which is one of the reasons so many 
apply. Still, it gives us a chance to 
dispel some myths. The media has 
presented the curriculum changes as 
being all about code, but that’s a red 
herring. It’s about computational 
thinking. We’re not teaching five- 
year-olds machine code.” 


Picademy 
isn't just limited to 
Pi Towers, or even 
Britain's borders 


“The Picademy’s Continuing Professional 
Development was excellent and it gave me 

many useful ideas to go back to school with, 
particularly the use of Minecraft Pi. It was a great 
experience to spend time with like-minded people 
who could see how the Pi can be of benefit in 
supporting the computing curriculum. | use the Pi 
in my school, and | teach workshops on Minecraft Pi 
and Python programming.” 


Sarah Zaman, primary computing teacher 
and Raspberry Pi certified educator 
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SUPER-TEST 


Which operating system should power your Raspberry Pi: 
We put four top Pi distros to the test... 


We installed 
the distros ona 
Pi Model A and 
Raspberry Pi 2, 
using an EMTEC 
8GB Class 10 
SD card anda 


Pidora bits SanDisk 8GB 
Class 10 microSD 
card. We used a 
Mac Pro 3,1 with 
SD Formatter 4 
to install each 
OS. We also 
used a Microsoft 
LifeCam VX- 
7000 and 

Maplin AD-102 
breadboard 
during the test. 


Raspbian notes 


he Raspberry Pi packs 
an amazing amount 
of power into its tiny 
frame. But hardware is only half 
the story; the other half is the 
software you choose to control it. 
When setting up your Raspberry 
Pi, there are a myriad of operating 
systems (OS) to choose from, most 
based on different distributions of 
Linux (‘distros’ for short). 

Raspberry Pi users will be 
familiar with Raspbian, the 
operating system based on Debian 
Wheezy Linux that is marked as 
‘Recommended’ during NOOBS 
setup. Raspbian is great to get 
started with, but it’s far from the 
only OS available. 

Every Raspberry Pi owner 
should take some time out to 


Snappy, 


to the retro-infused alternative 
approach of RISC OS. 

But which OS is the best to use? 
There’s only one way to find out. 
In this test we looked at four key 
OS options: Raspbian, Pidora, 
RISC OS, and Snappy Ubuntu Core. 
All are free and have versions 
designed especially for the Pi. 

That’s not to say they’re all 
the same: Raspbian and Pidora 
use different default desktop 
environments and Snappy Ubuntu 
Core doesn’t yet have a desktop at 
all — software is installed using a 
brand new package manager called 
‘snappy’. RISC OS is an entirely 
different creature from anything 
you are likely to have used before. 

Each OS offers something 
unique, and all are interesting 
and worth exploring. But which 
distro should be your main go-to 
operating system? That’s what 
this group test is determined to 
find out. 
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Pidora Snappy Ubuntu Core 


Packing the power of Fedora into the Fast and futuristic, but may be a little too 
Raspberry Pi advanced for most users 


Compatibility: Raspberry Pi 1 Compatibility: Raspberry Pi 2 
URL: pidora.ca URL: developer.ubuntu.com/en/snappy 


Pidora is a remix of the popular Fedora flavour Snappy is the most recent OS for the Pi. Users 

of Linux. Currently in its fifth version, the Pidora expecting standard Ubuntu with its Unity desktop will 
distro has come a long way since 2012, but it be surprised. Snappy is a command-line affair aimed 
still stands in the shadow of Raspbian. Pidora is squarely at developers looking to build web servers 
part of NOOBS, but adoption and support has and Internet of Things (loT) devices. The apt-get 

been dropping ever since Raspbian became the function is replaced with snappy, which offers some 
recommended installation. great innovations regarding software deployment. 


IMPORTANT!!! 


Key features: Key features: 
© Based on the popular Fedora version of Linux. ® Command-line interface with no desktop 


© Optimised for ARMV6 architecture; doesn't work installation available. 
with the Raspberry Pi 2. ® More robust ‘transactional’ software updates that 


® Default Xfce desktop is good-looking but are guaranteed to work. 
sluggish compared to LXDE. * Software packages installed using we Piano Teach 
oo re 


d (@) ra of apt-get. S 


Pidora looks every bit as powerful as its Snappy Ubuntu Core offers a range of new 
bigger brother, but badly needs optimisation features that are ideal for server and loT developers 


Raspbian aiseves_] RISC OS 


The recommended distro keeps going from Flashback from the 1980s that's still going 
strength to strength strong today 


Compatibility: Raspberry Pi 1and 2 Compatibility: Raspberry Pi1 
URL: raspbian.org URL: RISCosopen.org 


Raspbian is based on Debian Wheezy but optimised Created during the heyday of Acorn Computers, RISC 
for the Raspberry Pi hardware. Technically, Raspbian OS was designed explicitly for the ARM chipset and 
isn't the official OS and isn't affiliated with the has been kept alive by a small team of dedicated 
Raspberry Pi Foundation. However, its ‘recommended enthusiasts. RISC OS is ultra-fast, but hails from a time 
installation’ status, along with plenty of documentation before the modern GUI metaphor had settled, and its 
and support, make it feel official. Raspbian is definitely WIMP (Windows, Icons, Menu and Pointers) interface 
the place for newcomers to start. has more than a few quirks. 


Key features: 
e Ultra-fast thanks to its ARM focus and small footprint. 


Key features: 

° Largest user base, and most documentation and 
tutorials reference Raspbian. ® Great for low-level programming and getting close 

to the ARM instruction set. 


Untitled 


® Compatible with all models of Raspberry Pi. 
® Quirky desktop interface and lack of widespread 


© Lightweight interface is fast and responsivggewag it 
= ; adoption make it difficult to learn. 


has a built-in Pi Store. ( 


RISC OS Looks normal on the surface, but is 


Raspbian is the recommended distro for newcomers radically different to other operating systems 
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Installation 


Pidora 
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TEST 2 


Hardware support 


Raspbian 
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Snappy Ubuntu Core 
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Pidora 
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We started our test using SD Formatter 4 to wipe 
our SD cards and installed NOOBS (New Out Of Box 
Software). NOOBS enables you to choose from a list 
of operating systems, including three on test here: 
Raspbian, RISC OS, and Pidora. 

Raspbian starts up with a Software Configuration 
Tool that enables you to reclaim space on the SD 
card, change the password, choose boot options, 
and enable support for the Raspberry Pi Camera. 
Pidora has a more basic Setup Agent, which walks 
you through creating the user account. RISC OS boots 
straight into the GUI. Installation was straightforward 
in all these operating systems. 

Snappy Ubuntu Core is the exception in that it has 
to be installed manually, using the dd tool to copy files 
from the image file to the SD card. 

Upon startup, you’re faced with a command line 
that informs you that apt-get has been replaced with 
snappy. (The password and login are both ‘ubuntu’). 
Because the Raspberry Pi doesn’t sport a clock 
backed up by battery, the date in Snappy is set to 
1970 on start-up, and this prevents snappy software 
installation, so part of each startup process is using 
date -s to correct the date. 


& RISC OS 


Pidora gets a black mark because it doesn’t support 
the Raspberry Pi 2. Attempting to choose Pidora 

in NOOBS brings up: ‘Warning Incompatible 
Operating System(s) Detected’. We tried anyway, 
but got a blank screen for our troubles. So for 

the rest of this test, Pidora was relegated to our 

Pi Model A. 

Meanwhile, Snappy Ubuntu Core only supports 
the Raspberry Pi 2, which leaves a considerable 
amount of Raspberry Pi devices out of the loop. 

All of our distros had no trouble recognising 
the keyboard, mouse, and network connection. 
Where things became a little more complicated 
was regarding accessories and GPIO. This is 
another area where Raspbian is rewarded by being 
the recommended distro. We had little trouble 
setting up our webcam and GPIO in both Raspbian 
and Pidora, but tutorials were easier to source for 
Raspbian. We couldn’t get the webcam to work 
in RISC OS; GPIO in RISC OS is possible, but it’s a 
confusing setup process. 

The RPi.GPIO package isn’t present in the 
snappy list of software, so GPIO access is currently 
unavailable in Snappy Ubuntu Core. 
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TEST 3 TEST 4 


Software support Programming and GPIO 


Raspbian Pidora Raspbian 
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RISC OS Snappy Ubuntu Core RISC OS Snappy Ubuntu Core 
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Every OS comes with pre-installed software and can Both Raspbian and Pidora make it pretty 
download and install additional software via the internet. easy to cover the basics of programming, and 
n Raspbian, software is installed using apt-get or via accessing the GPIO is acase of downloading the 
the Pi Store. correct library (such as RPi.GPIO for Python or 
In Pidora, Yum is used to install software, but youcan Scratch GPIO). 
install Apt from Yum if you prefer (and then install the Snappy Ubuntu Core comes with Python, 
Pi Store manually). but without apt-get there was no way for us to 
RISC OS has a built-in store where you can download install the RPi.GPIO tools. Snappy Ubuntu Core is 
new software created by the RISC OS community. tremendously interesting to advanced developers 
However, a heartbreaking aspect of RISC OS is that you though, and is an ideal platform for setting up 
have to use BeebIT and ArcEm emulation software to your own web server, but beyond that it’s far from 
run the rich library of older BBC Micro and Archimedes an ideal environment for learning to code. Distro 
software, which you could do just as easily from any RISC OS is either a fantastic or dreadful 
Linux distro. programming environment, depending on what 
Ubuntu Snappy Core replaces apt-get with snappy: you want to learn. Press CTRL+F12 and enter 
programs are split into frameworks and apps(whichare basic to access BBC Basic, a fantastic starter 
isolated like apps on mobile devices). Snappy installs language that brings tears to the rose-tinted eyes 
programs using a transactional update system that of many a seasoned developer. 
downloads components before updating or installing Beyond nostalgia, RISC OS is particularly good 
and can roll back programs to earlier versions). for low-level programming and learning assembly 
It also supports WebDM, which enables you toconnect language (BBC Basic features an inline assembler). 
to your Pi from a web browser and install or remove Absent are many modern high-level programming 
software. Snappy is very interesting, but very little languages. That sais, RISC OS has its charms for 
software is currently available. many fun projects. 
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Good community support is vital for getting the most 
out of your Raspberry Pi. It’s unsurprising to learn 
that Raspbian, as the recommended installation, has 
the best community support. 

All of the projects from the Raspberry Pi Foundation 
and many other sites (raspberrypi.org/community) 
gravitate around Raspbian. 

Having said that, it’s worth noting that Fedora, 
the flavour of Linux behind Pidora, has a large and 
respectable community. In particular, Linus Torvalds, 
the initial developer of Linux, is known to use Fedora 
(even if somewhat begrudgingly). 

Of course, numbers and celebrity names aren’t 
everything and the RISC OS community 
(RISCosopen.org/forum) is both dedicated and 
committed. It’s a small clique, though, and outside 
of the community you’ll struggle to find much 
online documentation. Look instead to decent 
books like David Bradforth’s First Steps with RISC 
OS 6 and Bruce Smith’s Raspberry Pi RISC OS System 
Programming Revealed. 

Snappy Ubuntu Core fares worst in this test with no 
real community to speak of, but that’s only because it 
is such a newcomer. Give it time. 
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Each of the operating systems has something 
different to offer. Raspbian has the most all-round 
support, the widest range of programs, and is the 
most nurturing environment. 

Raspbian is also noticeably faster and less error- 
prone than Pidora. While Pidora’s lack of Pi 2 support 
makes any meaningful speed test impractical, we’d 
put our money on Raspbian and Snappy Core’s armhf 
rchitecture beating Pidora in any speed test. 

Pidora is worth investigating if you work ona 
Fedora-based main computer, own a Raspberry Pi1, 
and want consistency between the two machines. 

Snappy Ubuntu Core has much to offer those 
looking to play a part in the next wave of software 
development. Developing Snappy apps isn’t a game 
for newcomers, but the transactional deployment 
techniques seem worth learning. And it’s a good OS 
for setting up a web server. Whether you can make 
anything out of it currently depends on your skill as 
a programmer, but we are looking forward to seeing 
Snappy Ubuntu Core develop as an OS. 

RISC OS is nothing if not unique. We’ve made much 
of its individuality throughout this group test. Suffice 
to say it’s a fantastic way to broaden your horizons. 
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First release 
Latest release 
Default desktop 


GPIO access 


Pi models supported 


Included with NOOBS 


OS family 
Base 
Developer 


Contact 


Architecture 


All Distros 


www.raspberrypi.org 


Raspbian 


01/06/12 
16/02/15 

LXDE 

Yes 

Pi 4, Pi 2 

Yes 

Linux 

Debian Wheezy 
Raspbian Team 


raspbian.org/ 
RaspbianTeam 


armhf 


Spec comparison 
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RISC OS 


05/11/12 
25/04/15 
Pinboard 
Yes 

Pi 1, Pi 2 
Yes 

RISC OS 
RISC OS 
ROOL 


riscosopen.org/ 
content 


armhf 


Pidora 2014 


01/10/12 
24/07/14 
Xfce 

Yes 

Pii 

Yes 

Linux 
Fedora 
CDOT 


cdot.senecacollege.ca 


armv6hlL 
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THE LAST WORD 


We expected this to be a much closer race, but 
Raspbian has — if anything — increased its lead over 
other operating systems, especially Pidora. 

One exception may be Ubuntu Snappy Core, which 
is a wholly different proposition. This innovative 
distro’s snappy package manager and WebDM 
interface point to an interesting future for software 
installation, but without the familiar apt-get 
installing the usual options is much more challenging. 


RISC OS remains great fun in a Monty Python-esque 
‘now for something completely different’ way. It’s a 
good tool for learning assembly, but the absence of 
many modern high-level programming languages 
prevent it from becoming more than that for many. 

We’ve always thought Raspbian is best for newcomers, 
but it’s hard to credibly recommend any other OS for 
general use. Our advice? Use all of them to find a good fit 
for you, but always have Raspbian on hand. 
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02/02/15 
03/02/15 
None 


No 


No 

Linux 
Ubuntu 
Canonical 


developer.ubuntu. 
com/en/snappy 
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HOZWALL F 


For his flagship art installation in Nashville, Joseph Hazelwood brings 


old and new video technology together with the Raspberry Pi... 


P 


he #O0ZWall video 
T installation, the brainchild 
of Joseph Hazelwood, sits 
in the ‘Escaparate’, the focal point 
of Nashville Tennessee’s centre for 
world-class contemporary art, OZ 
Arts (ozartsnashville.org). 

Before becoming a hotbed for 
creatives, the space was actually 
a cigar warehouse that held over 
100,000 of the owner’s private 
cigar blends. 

“From what I’m told, it was 
originally one of the largest cigar 
humidors in the world,” quips 
Hazelwood, before getting to the 
crux of the project. 
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“A visitor to OZ will walk in the 
Escaparate and be drawn into an 
interactive multimedia experience. 
We like to think of this installation 
as a canvas for other artists to 
build upon, and that’s the beauty 
of open source and platforms like 
the Raspberry Pi.” 

Hazelwood has effectively 
retrofitted six vintage TVs with 
modern LCD panels, though he 
plans to double this to 12. “Each TV 
is outfitted with its own Raspberry 
Pi 2. We used the code from the 
CCFE Pi Wall project (ccfe.ac.uk/ 
computing _projects.aspx) and 
tailored it to our needs. 


“Right now we have it displaying 
one large image and switching 
content via video editing, but in 
the long run we plan to use the 
Raspberry Pis to switch content 
and to make the wall more 
dynamic and interactive. We 
may also add cameras, motion 
detectors, and other sensors to 
the room/building for all manner 
of interactivity.” 

You can learn more about the 
#OZWall video installation and 
Joseph Hazelwood’s fascinating 
penchant for juxtaposing 
old and new technologies at 
hazelwoodlaboratories.com. 
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Image: Sam Frawley, www.samfrawley.com 


As shown from the rear, each TV in the #OZWall video 
installation is powered by its own Raspberry Pi 2 
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The programming aspects of the project were taken 
care of by developer Phillip Lehner 
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Joseph Hazelwood retrofitted and lovingly restored old 
TVs with modern flat screens 
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9000 


Willem Koopman opens the pod bay 
___ doors on his latest Raspberry Pi project: 
» a fully functioning H.A.L. 9000... 


nspired by a BBC Radio 4 

documentary celebrating 

the theatrical rerelease of 
Stanley Kubrik’s 1968 epic 2001: 
A Space Odyssey (bbc.in/1vc3NG8), 
Willem Koopman decided to build 
his own homage to this particular 
piece of cinematic history —a 
working model of H.A.L. 9000, the 
ship’s computer. 

Much like the original H.A.L. 
who so famously lost his digital 
marbles part way through the 
film, Willem’s effort still needs 
code to be added and polished: 

: ae “The eventual plan is to have it 
Ta TD aR eae ee i as a work bot, so that when the 
pre yoy Seren : website breaks or someone make 

a loud noise, we can take a picture 
for prosperity and/or automatically 
shame the perpetrator.” But it 
already performs some suitably 
clever — and fitting — parlour tricks. 

“At the moment, it runs a very 
lightly modified version of Jasper 
(jasperproject.github.io), which 
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Sci-fi fans will 
instantly recognise 
the design, which 
is near identical to 
the one in the film 


allows a basic Siri-like behaviour. 
You can ask it to do various things 
like tell the time, check emails 
and Facebook — basically, all the 
marvellous things that Jasper 
allows you to do. You can also 
ask it to open the pod bay doors.” 

Besides the Raspberry Pi- 
powered elements, there was 
an awful lot of work involved in 
getting the case to look just right — 
not least the eerie fisheye with its 
chilling red backlighting. 

“T was researching how the 
original was made and found 
out that the ‘eye’ was a standard 
Nikkor 8mm fisheye. Many years 
ago, | bought a wide-angle lens 
converter (the sort used to make 
skateboard videos before many 
readers were born). I dug it out, and 
the plan snowballed from there.” 
The lighting is catered for by two 
well-placed LEDs. 

The case itself was created 
using laser-cut MDF. “Cheap laser 


raspberrypi.org/magpi 


cutting is the most marvellous 
innovation of modern times,” 
enthuses Willem. “Just create an 
SVG, send it off, and a few days 
later precisely machined parts 
arrive in the post. I can design 
and build straight dovetail joints 
to within 0.2mm, all without a 
chisel!” 

While the cutting was pain-free, 
the painting process has been 
anything but. “I spen about three 
weeks trying different techniques 
to get the glossy spray paint to 
actually stick.” Willem says that 
the moral of the story is to always 
use a decent undercoat, but stay 
away from spray primers. “Lightly 
sand to get rid of the brush 
strokes. Repeat.” 

Watch out in the coming months 
for a tutorial to set up Jasper to 
create your own personalised Siri 
with the Pi, but until then you can 
learn more about Willem Koopman 
from his blog: secretbatcave.co.uk. 


H.A.L. 3000 


Projects 


The business end of the project comprises the Pi, 
speakers, a Camera Module, and a USB microphone 
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Willem used an old wide-angle lens converter 


to create H.A.L's iconic ‘eye’ 


Hiding behind the lens is the Camera Module 
and two LED lights, one on either side 
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It's noticeably different 
from the original Power 
Glove - Cory felt he 


achieved a DeLorean feel 


with the result 


Some of the original PCB 
had to be cut away to allow 
the Arduino to fit inside, but 
most buttons still work 


<.. 


Quick 


» It took seven 
days from 
conception to 
presentation 


» Cory’s son 
helped with 
the soldering 


» The Power 
Glove was 
an official 
Nintendo 
licensed 
product 


» Itaccepts two 
Wii Remotes as 
controllers 


» Itwas created 
as part of a 
‘show-off’ 
meetup 
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Play on your own or with 
a friend via the screen 
on your wrist, using a Wii 
Remote, the control pad, 
or your fingers 


PWNGLOVE 


The infamous NES peripheral, the Power Glove, has been the butt of 
many jokes and centre of a lot of nostalgia. What happens when you 
don’t need the rose-tinted glasses any more? 


et’s face it, once you take 

off your rose-tinted glasses 

and forget the quotes and 
memes surrounding cult 1980s 
adver-film The Wizard, you’ re left 
with a barely functional peripheral 
that is very much a product of its 
time. The Power Glove was a novelty 
and, while it captured the minds of 
many young children, it never quite 
lived up to its promise at the time. 
Apparently, it’s this exact reason 
that got Cory Kennedy motivated. 

“The PwnGlove was a project 

rooted in the desire to build 


the memory my 12-year-old 

self was deprived of, thanks to 
the marketing genius behind 
Power Glove’s capabilities,” 

Cory explains to us. “I saw other 
people doing all sorts of projects 
with Power Gloves and I thought 
it would be a perfect match to pair 
it with retro NES gameplay.” 

It was originally created for 
Cory’s information security 
meetup’s ‘Hacker Show-off 
Contest’, where he had 15 
minutes to wow the crowd with 
his invention. Although the focus 


was information security, Cory 
wanted to try something else: 

“T wanted to do something 
different, mainly because where | 
am today professionally is rooted 
in tinkering — not only with 
computers at a young age, but also 
videogames... I wanted to be the 
kid from the ‘now yow’re playing 
with power’ ad. Which is exactly 
why I added the NeoPixel array.” 

As well as being a pretty good 
fit for the inside of the Power 
Glove, the Raspberry Pi came 
in very handy for enabling 
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As well as being a pretty good fit for the inside of the 
Power Glove, the Raspberry Pi came in very handy 


PWNGLOVE 


for enabling Bluetooth and Arduino interaction 


Bluetooth, Arduino interaction, 
and access to the actual games. 
“The bodywork was tough, 
mainly trying to resist the urge to 
take away from the original look 
too much,” Cory says, regarding 
actually getting everything into 
and around the glove. “I say 
that, but then I take a look at the 
monstrosity it has become and | 
have to say... It now reminds me of 
the Back to the Future DeLorean.” 
He did try to use as much of the 
original parts as possible, though. 


START PLAYING WITH POWER 


“Tt leverages all the original 
components, modified physically 
a bit to cut [out] the non-essential 
PGB, to allow for room for new 
components. There are four 
original bend sensors (thumb, 
index, middle, and ring), which 
connect to an analogue multiplexer 
living in the palm housing, 
which sends that data back to the 
Arduino. This is all piped over 
Bluetooth back to the Raspberry Pi. 
The wrist pad buttons are mostly 
intact (programming buttons 


aren’t working), and they are set 
up now to do things like allowing 
the Konami code and switching the 
colour and pattern sequence on the 
NeoPixel array.” 

Cory is forever making tweaks 
to his PwnGlove, improving it in 
minor ways to solve what he sees 
as problems, but admits that most 
people don’t even notice. 

“To be honest, the reactions 
it gets from people, especially 
kids, certainly makes those 
imperfections disappear.” 


Above The lights 
on the glove 

are supposed 

to pay homage 
to advertising 
material for the 
Power Glove 


Above Left An 
Arduino can be 
found in the 
original circuit 
compartment, 
plus a screen and 
Raspberry Pi on 
the wrist 
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Using the standard 
Raspberry Pi Camera 
module, Tom is 

able to do some 
astrophotography 


The Raspberry Pi 
Model B+ is just the 
thing to perform the 
complex calculations 
for the telescope 


» The whole 
thing only took 
a few hours 
to make 


SS > YOu don't 
need a very 


expensive 
telescope 
for this project 


» You can see 
the camera 
preview ona 
remote desktop 


» Tom wants to 
have Wolfram 
control the 
motors next 


» The whole Pi 
setup weighs 
less thana 
normal CCD 
camera 
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This custom-made mount 
slots snugly into the 
viewfinder of the telescope 
and ensures the Pi camera 
isn't affected by stray light 


MATHEMATIC 
Tee eer t 


The Raspberry Pi has access to a huge amount of mathematical 
power and knowledge, thanks to Wolfram’s Mathematica - 
here’s how one man uses it for stargazing... 


pace. The final frontier. 

This is the adventure 

of Tom Sherlock. His 
mission: to explore the stars from 
his backyard, using a telescope 
to photograph stunning cosmic 
vistas. And he’s managed to make 
the process much better and easier 


for himself by using a Raspberry Pi. 


He needs more than a Pi, though 
— it’s good, but it’s not good 


enough to photograph close-ups 
of the Moon. In this particular 
instance, the Raspberry Pi is 
connected to a telescope using 
a custom-made mount to slot 

it into the eyepiece, so that the 
Raspberry Pi Camera module 
can take these excellent photos. 
On its own, it’s impressive 
enough, but Tom has added a 
few more tricks to make it a 


truly unique Pi project — namely, 
he can control it with Wolfram 
Language and Mathematica. 
“Mathematica combines 
a powerful language, device 
control, and image processing 
facilities with a great deal of 
built-in data,” Tom explains to 
us. “This includes astronomical 
data, so it was not hard to see the 
advantage of having one piece of 
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software which could manage 
all these tasks in a unified, 
scriptable way.” 

Tom actually works at Wolfram 
on Mathematica, so is well versed 
in the ways of the language and 
Mathematica itself. He’s also an 
amateur astronomer, which is where 
the idea came from in the first place: 

“Over the past decades and 
especially in recent years, amateur 
astronomy has become more and 
more dependent on computers 
for various tasks, like planning 
observations, pointing and driving 
the telescope, capturing and 
processing images and data, and 
finally sharing images and data with 
other astronomers. 

“Typically, you have to run several 
different packages on several 
different computers to accomplish 
these tasks. For example, you 
might plan observations with one 
package, control the telescope with 
another package, capture images 
with still another package, and then 


On its own, it’s impressive enough, 
but Tom has added a few more tricks 
to make it a truly unique Pi project 


process the images with one or more 
additional packages, sometimes 
involving specialised plug-ins.” 

Tom was able to solve all these 
complications thanks solely to the 
Pi having Wolfram available with 
Raspbian. Just having a Piand some 
coding skills is only one part of the 
challenge, however, as telescope 
selection is also important. 


MATHEMATIC TELESCOPE 


© MocnTestne . Wott Mathemabea 100° 
[Ele (de Insert Fepmat Set Graphics Lyshatien Balettes Window Help 


moonlmage = Import("irampiatit! =r « 1028 ‘ +, nara") 


“Tt has to be controllable from Above The Pi 
s camera might 
a computer,” Tom elaborates. Ratbeerine 
“Many scopes these days have tas fidelity, 
2 ut it can 
computerised mounts, and take stunning 
the computer built into the shots when 


‘ d ect 
mount will let you select any a aes aed 


object in the mount’s internal 
database and slew the scope to 
that object. Generally, these 


mounts will also allow you to 
connect them to an external 
computer and then, using the 
correct protocol, specify an 
arbitrary set of coordinates. Since 
Mathematica has the coordinates 
of hundreds of thousands of 
different objects, you can easily 
look things up and have the scope 
slew to that object.” 

It all sounds good in 
theory, but just how does 
it work in practice? 

“Remarkably well, 
considering how much 
the Piis doing. The main 
problems I found were 
more details than anything 
else. It takes a bit of time 
to look up astronomical 
coordinates on-the-fly, so 
I found it was better if I did 
that ahead of time instead 


a 
> 


10%» 


Above Just a Raspberry Pi Model B+ is needed to perform 
the complex calculations needed for the telescope 
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of ‘in the field’.” 


Projects 


SEEING 
STARS 


The setup, according to Tom 
Set up the scope and mount, and 
perform the mount’s alignment 
procedures so that its computer 
knows how it is oriented, with 
respect to the Earth and the 
celestial sphere. 


Attaching the Raspberry Pi 
Once the telescope is sorted, 

then you just need to attach the 
Raspberry Pi. Tom uses a serial-to- 
USB adaptor to do this, then boots 
up the Pi. 


Do the maths 

Once the Pi is booted up and in 
Mathematica, you can start issuing 
commands using the Wolfram 
Language to control the telescope -— 
this will change depending on what 
mount you're using. 
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BUILD YOUR OWN 


ALARM CL& 


Solve real-world electronic and engineering problems with your Raspberry Pi 


Half-size 
breadboard 


Adafruit LED 
backpack 
(1270 or 878) 


Standard servo 
motor 


Tactile push 
switch 


Jumper wires 


1k ohm resistor 


DC barrel 
(CPC: CN19646) 


6V DC 1A power 
supply (this just 
supplies power 
to the motor) 


Metal lid or 
baking tray 


Block of wood 


A fork! 


28 | MdgPi May 2015 


SIMON MONK 


Simon Monk is the author of 
the Raspberry Pi Cookbook and 
Programming Raspberry Pi: Getting 


Started with Python, among others. 
simonmonk.org 
monkmakes.com 


and the help of renowned technology hacker and author, Simon Monk 


veryone with teenage kids knows that they person to be woken remotely, over your local network 

can require considerable encouragement to or even the internet. 

be extracted from their beds in the morning. As you’ll see from the list of required components, 
This helpful project is an automated variation on this project uses a breadboard and an Adafruit LED 
banging a cooking pot with a metal implement. The display module. The latter is supplied as a kit which 
project also has a nice bright 7-segment LED display does require some simple soldering. 
and an ‘Off’ button that allows the alarm to be This project also requires a little mechanical 


cancelled. You can see a video of the project in action construction. You will need a drill and assorted 


at youtu.be/zold22xfCqk. screws to attach the lid and also to fix the fork 
The alarm time is set using a web interface for the to the servo arm. The fork also needs to be 


project, so you can even adjust the alarm time for the hammered flat. 


. 
olan fF 


DISPLAY Seeae8: 
Bem? 


a mem; 
Bm: 
@, 


The time is shown on a four- Weuse this servo motor-  e— 
digit LED display. The larger 6 powered arm to bang on 


display uses an extra pin the biscuit tin lid 
(extra wiring demonstrated) 


So make sure that you have 


5 Ss 
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BANG! BANG! BANG! BANG! 


adult supervision (assuming you need it), and eye 
protectors when hammering and drilling. 

The breadboard, jumper wires, switch, and 
resistor are probably best bought as an electronics 
starter kit. The Monk Makes Electronic Starter Kit 
for Raspberry Pi includes these parts. Most starter 
kits for the Raspberry Pi will include the breadboard, 
jumper wires, and some resistors. 


Servo motors 

The key to this project is the servo motor that 
repeatedly moves to bang the metal lid. Servo 
motors are different from more conventional 
motors in that they are not free to rotate round 
and round. In fact, they can only normally rotate 
about 180 degrees. 

Servo motors have three leads: two power leads 
(ground and 6V) and a control lead. The control lead 
is fed a series of pulses of varying length. The length 
of the pulses will determine the angle to which 
the servo motor is set. If the pulses are around 
1 millisecond, the arm of the servo will be at one 
end of its range (let’s call that o degrees). A pulse 
length of 1.5 milliseconds will position the servo 
arm right in the middle of its range (90 degrees) 
and a 2 milliseconds pulse will put the arm at the 
far end of its range (180 degrees). In practice, servos 
often don’t do the full 180 degrees and the range is 
sometimes more like 0 to 170 degrees. 


1.0 mS 1.5 mS 2.0 mS 
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Follow the annotated breadboard diagram, taking care to ensure that all the 
components and jumper wires fit into the correct rows on the breadboard. 
The difference between the two Adafruit displays listed in the ‘You'll Need’ 
box is that one is a lot bigger than the other. The larger display actually has 
two positive power pins, which is why there are two rows on the breadboard 
connected to 5V for the display. 


>STEP-01 

Build the breadboard 

In this project, the breadboard is 

mostly used as a way of bringing 

together the connections from the Mii 

servo motor, power supply, and % i rq | F 

display. Start by fitting the display <= a. 

onto the breadboard, and then the i‘ Lf | 1 Ll ( J ( 
resistor switch and leads to connect - ae : 
to the Raspberry Pi. 


>STEP-02 

Connect the breadboard 

Attach male-to-male jumper wires to 
the screw terminals of the barrel jack 
adaptor. Use red and black leads and 
make sure that you attach the red lead 
to the screw terminal marked ‘+: The red 
lead plugs directly into the connector 
on the servo with the servo's red lead. 
The black lead from the barrel jack 
goes to the ground bus. The brown 
servo lead is the ground lead and the 
orange lead the control lead. Attach 
the female-to-male leads from the 
breadboard to your Raspberry Pi. 


>STEP-03 

Preparing the hardware 

We would advise coming back to 
these final two steps after you have 
tested out the project software, as 
lining up the servo arm will depend 
very much on the exact position of 
the servo and lid. Hammer the fork 
flat. Be careful because it may fly up 
and hit you when you whack it. The 
fork can then be attached to the 
servo arm using screws. 


>STEP-04 

Fix the hardware to a base 

Find yourself a small block of wood 
that can act as a base to hold the 
servo and the tin. Fit the lip of the 

tin to one end of the block and the 
servo to the side of the block, so that 
the fork will just reach the tin to hit it. 
This is best done with the software 
running and the servo moving. 
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Tutorial 


WALKTHROUGH 


The program will start 
a web server on your Pi 


Below The 
complete project 


including sweet tin 
lid and clangy fork! 
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Now that the hardware side of the project is complete, 
we just need to get the software running. The program 
is written in Python and uses a library called Bottle. If 
you made the previous project in this series (a web door 
lock), you should already have Bottle installed. If not, to 
install Bottle, make sure that your Raspberry Pi has an 
internet connection and then run the commands: 


sudo apt-get update 
sudo apt-get install python-bottle 


You can download the program from your Raspberry 
Pi command line, using the command: 


git clone https://github.com/simonmonk/ 
pi_magazine. git 


Adafruit has a library of Python code for using its 
displays (github.com/adafruit/Adafruit-Raspberry- 
Pi-Python-Code). The files needed for this project 
are copied into the code you just downloaded, so you 
don’t need to install this again. You may need to set up 
your Pi to be able to use the [°C serial communications 
mechanism used by the Adafruit display. If you get error 
messages relating to the display when you try to run the 
program, follow the instructions here to enable PC: 
raspberrypi-spy.co.uk/2014/11/enabling-the-i2c- 
interface-on-the-raspberry-pi. 

Before you run the program, open it in an editor 
such as nano, and change the value of the IP_ADDRESS 


variable to match the IP address of your Raspberry Pi. 
You will also probably need to change the variables 
START_ANGLE and END_ANGLE, which set the range 
of travel of the servo when it’s doing its banging. 

To run the program, change to the directory where 
the code for this project lives and then run the 
program, using the commands below: 


cd /home/pi/pi_magazine/@3_alarm_clock 
sudo python alarm_clock_server.py 


This will start a web server running on your Raspberry 
Pi. You can check this by opening a browser window on 
another computer or your phone and entering the IP 
address of your Pi. For our Pi, it was 192.168.1.14. If all is 
well, a webpage will be displayed inviting you to enter 
a time at which the alarm should be sounded. 


How the code works 
Alarm_clock_server.py is a pretty heavily commented 
Python program. You will probably find it handy to have 
the code open while we go through it. 

The program starts by importing the Bottle, 
RPi.GPIO, datetime, time and Adafruit_7Segment 
libraries it needs. Then there are some constants that 
you may need to tweak. You have already met 
START_ANGLE and END_ANGLE. The DELAY_IN and 
DELAY_OUT variables may need altering in your setup to 
give the servo longer to reach the correct position. 

Two global variables are used: alarm_on and 
alarm_time. The variable alarm_on is a true/false 
value that records whether the alarm is enabled or 
not. Pressing the Cancel button will set this to False to 
stop the banging. The variable alarm_time contains 
the time for the next alarm to be triggered. This is 
in the format of two numbers for the hour (24-hour 
clock) followed by a colon, followed by two digits for 
the minute. Note: you must enter the colon when you 
type in the alarm time on the web form. 

Three utility functions are then defined, which are 
used by later functions. The set_angle function adjusts 
the pulse width for the PWM signal to set the servo arm 
to the angle specified. bong causes the servo to make 
one banging motion, and update_display updates 
the Adafruit LED display by splitting the time up into 
separate digits and writing them to the appropriate 
digits of the display. 

The next section of the code supplies the web 
interface. Bottle uses the @route directive to indicate 
that the functions that immediately follow it are 
handlers for web requests. So the default route page 
of ‘/ is handled by the function called index. The 
index function uses Bottle’s templating mechanism 
to return the HTML contained in the template file, 
home.tpl. You will find all the HTML templates used 
in the project contained in the code directory for it. 
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The homepage contains a form with an alarm time entry 
box and a Set button. 

The second handler is for the ‘/setconfirmation’ page, 
where the form from the index page is posted. This 
handler function extracts the alarm time from the web 
request and assigns it to the global variable. It then sets 
alarm_on to be True. 

Since this Python program is mostly acting as a web 
server, the code to check the alarm time and to update 
the LED display all happens in a separate thread of 
execution. This thread is started by the command 
start_new_thread, which causes the update function 
to, in effect, run independently of the rest of the 
program. The update function checks the current time 
against the alarm time and if they are the same, it calls 
bong to move the servo. It also checks for the Cancel 
button being pressed and updates the LED display. 

The last few lines of the program start up the web 
server on port 80. The try / finally clause is used to set 
the GPIO pins back to inputs when the program is quit 
using CTRL+C. 


(llarm_clock_server.py 


from bottle import route, run, template, request 
import thread, time, datetime 

import RPi.GPIO as GPIO 

from Adafruit_7Segment import SevenSegment 


IP_ADDRESS = '192.168.1.13' # of your Pi 


Using your alarm clock 
You can use your web browser on a computer, 
or your smartphone if it is connected to your 


Wi-Fi network. 
needs to havea 
connection also 
an 


f you find tha 


then you may need to use the raspi-config tool to set 


the time zone. 
f you 


styling 


home.tpl - th 


the password form. 


setconfirmati 
confirm the alar 


This is a fun ki 
experimentation and improvement, so dive into the 


code and see wh 


START_ANGLE = 5@ # start angle before moving to bong the lid 
END_ANGLE = 73 # end angle this should just be touching the lid 
DELAY_IN = 9.5 # delay to allow servo to get to start position 


DELAY_OUT = 
SERVO_PIN = 18 # control pin of servo 
BUTTON_PIN = 23 # pin connected to Cancel button 


segment = SevenSegment(address=0x70) 


GPIO.setmode(GPIO.BCM) 

GPIO.setup(SERVO_PIN, GPIO.OUT) 

pwm = GPIO.PWM(SERVO_PIN, 100) # start PWM at 10@ Hz 
pwm.start(@) 


@.1 # delay at point of bong before returning to start 


GPIO.setup(BUTTON_PIN, GPIO.IN, pull_up_down=GPIO.PUD_UP) 


alarm_on = True 
alarm_time = '' 


def set_angle(angle): 
if angle < 1.0: 


pwm.ChangeDutyCycle(@) # stop servo jitter when not 


banging 
else: 
duty = float(angle) / 10.0 + 2.5 
pwm.ChangeDutyCycle(duty) 


def bong(): 
set_angle(START_ANGLE) 
time.sleep(DELAY_IN) 
set_angle(END_ANGLE) 
time.sleep(DELAY_OUT) 
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internet time server. 


enjoy a bit of webpage design, then the first 
thing you will probably want to do is to add some 

to the webpages. The place to do this is in the 
template files. These are: 


ALARM CLOCK ‘Tutorial 


NEXT 
MONTH 


In the next 
project in this 
series, we will 
continue with 
the theme of 
time and hack 
an analogue 
wall clock. We 
can then make 
it run super- 
fast or slow or 
even use it to 
indicate things 
other than time, 
all using your 
Raspberry Pi. 


For this reason, the Raspberry Pi 
network connection. A network 
allows the Pi to synchronise with 


t your Raspberry Pi is an hour out, 


s is the homepage containing 


on.tpl - the page opened to 
m time setting. 
nd of project that lends itself to 


at else you can make it do. 


qanguage 


def update_display(): 
now = datetime.datetime.now() 
hour = now.hour 
minute = now.minute 
second = now.second 


>PYTHON 


segment .writeDigit(®, int(hour / 10)) # Tens 
segment .writeDigit(1, hour % 10) # Ones 
segment .writeDigit(3, int(minute / 10)) # Tens 
segment .writeDigit(4, minute % 10) # Ones 


segment.setColon(second % 2) # Toggle colon at 1Hz 


@route('/') 
def index(name='time'): 
return template(‘home.tp1') 


@route('/setconfirmation', method='POST') 
def confirm(): 
global alarm_time, alarm_on 
alarm_time = request.POST.get( ‘alarm time’, |‘) 
alarm_on = True 
return template(‘setconfirmation.tpl', t=alarm_time) 


def update(thread_name): 
global alarm_on, alarm_time 
while True: 
current_time = time.strftime(“%H:%M’) 
if current_time == alarm_time and alarm_on: 
bong() 
if GPIO.input(BUTTON_PIN) == False: 
alarm_on = False 
set_angle(@) 
update_display() 
time.sleep(@.1) # allow other threads to run 
thread.start_new_thread(update, (“update thread”,)) 


try: 
run(host=IP_ADDRESS, port=80) 
finally: 
print('Cleaning up GPIO') 
GPIO.cleanup() 
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DH OB Moicrscren- 


Bp i@ras spberrypr ~ 


pills HSU Jy) ey oF 


COMMAND LINE 


Raspbian's software repository 
contains many thousands of freely 
installable apps, just a command 


away from use 


Every file, folder, and even 
hardware component should have 


just enough pe 
use it - but not 


rmission for you to 
be over-accessible 


at the risk of security 


P1 PART 3: 


PERMISSION TO INSTALL 


Richard Smedley presents your cut-out-and-keep guide to using the 
command line on the Raspberry Pi. In part 3, we look at Raspbian’s efficient 
system for installing and updating software, among other things... 


Raspbian 
raspberrypi.org/ 
downloads 


- though most of 
the tutorial series 
will work with 

the command 
line running the 
Linux default 
Bash shell on any 
GNU/Linux PC. 


SHARED 
RESPONSIBILITY 


If you share your 
Pi, it's worth 
reading up on 


sudo - and the 
visudo command 
- to find how to 
give limited but 
still useful admin 
privileges to the 
other users. 
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updating. Keepin 
bloat and duplica 


missing files, and even totally u 


nstalling software should be easy, but behind 
every piece of software 
dependencies that also 


is an evolving set of 
need installing and 


g them separate reduces unnecessary 


tion, but adds the pote 


ntial for bugs, 


nresolvable clashes. 


Fortunately, Debian GNU/Linux cracked the 


problem back in the 1990s with 


Management sys 


the Deb 
tem and the Advanced 


ian Package 
Package Tool 


(APT); Debian-based systems, like Ubuntu and the 


Pi’s Raspbian, in 
show you the bas 
software and kee 
command line, a 


unrelated field of file ownership and permiss 


p your system up to da 
nd then look at the not 


Using the apt command to update yo 


of installable sof 
the command lik 


tware should be as sim 
eso: apt-get update 


herit all of the benefits. 
ics you need to know to install new 


Here we’ ll 


te from the 
entirely 

ions. 

ur system’s list 

ple as issuing 
— but try this 


logged in as user pi and you’ll just get error messages. 
The reason for this is that changing sys 


on a GNU/Linux (or any type of Unix) system 


tem software 
isa task 


restricted to those wi 


th administrative permissions: 


the godlike superuser, or admin, also known as root. 


Pseudo root, su do 


We’ll get onto permi 


ssions prope 


rly a bit later, 


but for now you’ll be pleased to know that you can 
fake it, using the sudo command. 


offers a fine-grained 
and groups to access 
powers. However, on 
quite rightly, that th 
just 


choice of pe 
portions of t 
the Pi, Rasp 


of acommand will p 


sudo apt-get update 
sudo apt-get upgrade 


e default user 
wanting to get on with things, and sudo in front 
retty much le 
have been warned. 

The following two commands will update Raspbian’s 
talled software (Fig 1): 


sudo potentially 
rmissions for users 
he admin user’s 
bian assumes, 

will be someone 


t you do anything; 
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je Edit Tabs Help 


pi@raspberr pi@ra 


Fig 2 Raspbian updates its listing of thousands of available apps - 
providing you give it admin permissions 


You can wait for one to finish, check everything is 
okay, then issue the other command — or you can save 
waiting and enter both together with: 


sudo apt-get update && sudo apt-get 
upgrade 


The && is a Boolean (logical) AND - so if the first 
command doesn’t run properly, the second one will 
not run at all. This is because for a logical AND to be 
true, both of its conditions must be true. 

It’s always worth running the update command 
before installing new software too, as minor updates 
are made in even stable distributions, should a 
security problem be found in any of Raspbian’s 
software. We’ve just run an update, so no need to 
repeat that for now. Sticking with a command- 
line theme, we’re going to install an old suite of 
terminal games: 


sudo apt-get install bsdgames 


Searchable list 
You can find particular apps with apt-cache search: 
apt-cache search games 

And examine individual packages with apt-cache 
show: apt-cache show bsdgames 

Apt is actually a front end to the lower-level dpkg, 
which you can call to see what you have installed on 
the system: dpkg -1. Even ona fresh system, that’s 
a large listing — we’ll show you how to get useful 
information from such listings another time. 

Downloaded packages hang around in /var/cache/ 
apt and if you find yourself short on disk space, 
issuing sudo apt-get clean will clear out the 
archive, without affecting the installed software. 

Now, remember the extra details that 1s -1h 
showed us in parti? Tryls -lh /etc/apt 

That -rw-rw-r-- at the beginning of the listing 
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COMMAND LINE 


File Edit Tabs 


pi@raspberr 


Fig 2 Raspbian tells you who you are, and what group access you 
have, for permission to use and alter files and devices 


for sources.list comprises file attributes, telling 
you who may use the file. Other entries in the 
listing have ad at the beginning, indicating they are 
directories. You’ll also see hardware devices have a 
c here, for character device- 1s -1lon/dev/input, 
for example. On Linux, everything is a file, even 
your mouse! Ana tells us this is just a regular file; 
it’s the remaining nine characters of the group that 
cover permissions. 

Every file has an owner and a group membership. 
Files in your home directory belong to you. If you’re 
logged in as user piand1s ~ -1, you’llsee pi pi 


Tutorial 


FREE TO USE 


Software in the 
main repository 
is not just free to 
use, but freely 
modifiable and 
redistributable 
too. Free 
software, like 
Raspbian’'s 
Debian base, is 
built on sharing 
- for education 
and for building 
community. 


Every file has an owner 
and a group membership 


in each listing, telling you the owner and the group. 
Note: we put the switch at the end this time - that’s a 
bad habit under certain circumstances, but we’ re just 
showing you what’s possible. Owner and group aren’t 
always the same, as1s -1 /dev will show you. 


Octal version 

Those numbers are an octal representation of 
user, group, and others’ permissions: in each case, 
read is represented by 4, write by 2, and execute 
by 1, all added together. So here we have 7s for 
read+write+execute for user and group, and 5 for 
readt+execute for all other users. 1s -1 and you'll 
see we’re back to -rwxrwxr-x. 

You can use chown to change who owns a file and 
chgrp to change which group it belongs to. Make 
a new text fileand sudo chown root myfile.txt 
— now try editing it and you’ll find that while you 
can read the file, you can no longer write to it. You 
can also make a file that you can write to and run, 
but not read! 

Next time we’ll be doing useful things with the 
output of our commands, but meanwhile have a go 
at robots from the bsdgames package we installed — 
it’?1l come in handy later for another purpose. 


PROBLEMS? 


Fine-grained 
permissions 
make for greater 
security, but 

can trip you up. 
Typing sudo 


in front of a 
command that 
doesn't work is 
both a diagnosis 
and a quick 
workaround of 
a permissions 
problem. 
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ALEX EAMES 


Alex runs RasPi.TV and RasP.iO, and 
finds himself between a blog anda 
hardware business. You can find him 
as @RasPiTV on Twitter. 

RasPi.TV 


ON RASPBERRY PI 


Download BBC TV programmes as high-definition MP4 files 
(without any DRM) for offline viewing on your Pi or other devices... 


et_iplayer is a fabulous, open source utility 


a program which allows you to see what’s Update your package lists 
sized SD card currently available from the BBC’s iPlayer We’re going to install some software. The first thing 
lnc §=§=website and download any TV programmes you want. you should do when you install software in Raspbian 
> A broadband You can choose resolutions between 512x288 and is — at the command prompt - type sudo apt-get 
connection 1280720, so you can pick one that suits your viewing update (and press ENTER), which updates your 
> A few lines device and storage capacity. There’s no DRM on these package lists. Then it’s a good idea to sudo apt- 
of code: files (although the BBC’s terms state that youareonly get upgrade (pressing ENTER again) once all your 
ee eae for 30 d db h f kages have b dated to their | 
raspitv/get_ allowed to keep them for 30 days), and because they software packages have been updated to their latest 
iplayer are BBC programmes, there are no adverts either, versions. It can take upwards of 30 minutes if you 
>ATV.ora making it perfect to use for films. haven’t done this recently. Then you need to add 


monitor and 
speakers 


Desktop raspberry .txt testserial3.py 
Win A cane i ~~ st er 


1B BIC 


Get_iplayer enables 
you to download 
films and TV shows 
from the BBC 
iPlayer service 


As the BBC doesn't 
use DRM, you can 
watch shows on your 
Pi or any other device 
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Jon Davies’s PPA (Personal Package Archive) to your 
sources.list. Copy and paste the five lines of GitHub 
code from github.com/raspitv/get_iplayer/blob/ 
master/code.txt into a terminal window on your 
Raspberry Pi and press ENTER. 


Install the keyring and software 

Once you’ve done this, you need to repeat the 
sudo apt-get update command in the terminal. 
You’ll likely get an error message about keyrings, 
so now you need to install Jon’s keyring as well 
with the following command: 

sudo apt-get --allow-unauthenticated -y 
install jonhedgerows-keyring 
Then press ENTER. 

Next, repeat the sudo apt-get update command 
one last time. Now we’re ready to go ahead and 
install the get_iplayer program itself (notice the 
installation name in the command we type is 
hyphenated, not underscored): 

sudo apt-get install get-iplayer 


Using get_iplayer 

Before we start, it’s always good to know where to 
find help, should you need it. To do this, type: 
get_iplayer --usage in the terminal, which 
should give us a list of the basic options. If you want 
more options, you can use get_iplayer --help, 

or even more using the command 

get_iplayer --longhelp. 

There are a lot of options, so it can bea bit 
overwhelming, but most of them are not needed 
for simple searching and downloading of content. 
Before we can download a programme, we need to 
collect the index of all the available content. This 
is done by using the get_iplayer command all by 
itself in the terminal. 
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Here's 
some example 
output from the 
get_iplayer 
--cat film 
command. Note 
the programme IDs 
(PIDs) on the left 


DO | HAVE 
ENOUGH SPACE? 


Narrowing down the search 

At any given time, there are a couple of thousand items 
available for download. That’s a bit overwhelming, so we 
need a way to cut it down a bit. You can use categories 
with the get_iplayer command - for example, 
get_iplayer --cat film. Youcan choose any 
category from the main list: Arts, CBBC, CBeebies, 
Comedy, Documentaries, Drama and Soaps, 
Entertainment, Films, Food, History, Lifestyle, Music, 
News, Science & Nature, or Sport. You can also use a 
keyword; if matched, it] return possible downloads. 


WANT SOUND 
THROUGH THE 


AUDIO JACK? 


Downloading content 
Looking at the list of films available, each item starts 
with the programme’s ID number (PID). Let’s choose 
Wallace and Gromit — The Wrong Trousers. This has a PID 
of 2210. So, to download this film at the best available 
resolution (1280x720), you would type: 

get_iplayer --get 2210 --modes best 
After about 10-15 minutes, the file is downloaded and 
processed into an MP4 file, which we can view, store 
or delete at will. 


Watching content 
As part of the default Raspbian installation, you have a 
GPU-accelerated media player called Omxplayer. Because 
it uses the GPU, it’s capable of playing HD video, even on 
a Pi Model A. To watch the film we just downloaded, we 
would type the following into the terminal: 

omxplayer [filenamehere] .mp4 

If you’re dealing with long filenames, once you’ve 
typed omxplayer and the first few letters of the 
filename, you can press the TAB key and it will auto- 
complete the filename for you (then press ENTER). 
You can see the full list of Omxplayer controls at 
elinux.org/Omxplayer. 
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Allitems on the Right-clicking a plug-in Plug-ins can have icons 
menu bar panel are on the panel will usually that change in response 
plug-ins, enabling bring up a menu, which to status - the network 
the layout to be contain options for both icon, for example, 
customised - this is the plug-in and the shows the current 
the ‘menu’ plug-in panel itself connection state 
3 Megu @ a = bes (a) eat (4) Google WB i @raspberrypi ~ : = = WA 0/0014 
t ? Add / Remove Panel Items 
Wastebasket = Remove “Task Bar (Window List)” From Panel 


i Panel Settings 


¥ Create New Panel 


© About 


=_— ~— hap 
Be BD 
| | a 
& Desktop alacarte-3. Desktop dhcpcd-6.7 
G 5. 1 
 Rubbist : 
BE BB 
OOg!e 
UI dhcped- bfm-1.2.3  Ixpanel-0.7 


Google Search I'm Feeling Lucky 


HACKING RASPBIAN'S 
DESKTOP PART 2: 
CUSTOMISING LXPANEL 


In part two of his series, Simon Long shows us how to change 
the appearance of the Raspbian desktop by playing with LXPanel... 


(Panel Preferences le ]| XPanel is acomponent of LXDE (Lightweight 
— Tl , X11 Desktop Environment), the desktop user 
Geometry | Appearance (Panel Applets Advanced L interface included as part of Raspbian. As the 
Currently loaded plugins Stretch M Add name suggests, LXPanel is responsible for generating 
Spacer L | | Bagnen panels — windows that overlay the desktop which can 
Menu _— be used for menu bars, application launchers, and other 
Spacer 0 *| Peimences general system functions. 
Application Launch Bar | Up By default, a single panel is displayed on the Pi’s 
Spacer O |! Down desktop, which is used for the menu bar at the top of 
Task Bar (Window List) ¥] — the screen. LXPanel also allows multiple panels to be 
Spacer Oo used on the same screen, So it is possible to have a 
System Tray second panel displayed at the bottom, to be used as an 
Right The Panel WiFi Networks (dhcpcdui) | application launcher, for example. Panels are always 
Aa oepsiiemnaitaed Al 4 attached to one edge of the screen, but the edge can be 
ocate space . 
dialog allows the top, the bottom, or even the sides. 
2 eee | Close _ Each panel can be customised to contain a selection 
and rearranged |_| _~—sCoff user interface components. These components 
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are called plug-ins, and there are two kinds. LXPanel 
includes a number of built-in plug-ins (including the 
main menu button, the taskbar, and the quick launch 
icon bar), and standalone plug-ins can also be written 
from scratch and added to LXPanel. Writing a new 
plug-in is a fairly complicated programming task and 
goes beyond the scope of this article, but information 
on how to get started with writing one can be found at 
the Ixde.org site. 

In addition to the plug-ins associated with a panel, 
there are a number of global parameters which control 
various aspects of the overall display of each panel. 
Many plug-ins also have parameters which can be set to 
control their individual appearance and behaviour. 


Tweaking the panel 

The easiest way to change the configuration of a 
panel or a plug-in is by using the LXPanel preference 
dialogs. If you right-click on a panel or one of its 
plug-ins, a menu pops up. (Note that some plug- 

ins override this menu, so don’t be surprised if this 
doesn’t work in some cases.) The top item on this 
menu is <name of plug-in> Settings — selecting this 
opens the preferences dialog for that particular plug- 
in; obviously, the items in that dialog will depend on 
what customisation is possible for the plug-in. 

The menu also contains a number of other menu 
items for customising the panel itself. 

Add/Remove Panel Items opens a dialog box which 
shows the plug-ins currently on the panel; from here, 
it is possible to add, remove, or rearrange the plug-ins 
on the panel. 

Also in the menu is Panel Settings - this opens a 
dialog which allows global settings for the panel to be 
changed, including the edge of the screen to which 
it is attached, and how much of the screen it takes 
up. Other tabs on this dialog allow the colour and 
background of the panel to be changed, and to control 
whether or not the panel automatically hides when 
the mouse is moved away, and reappears when it is 
moved back. Adding or removing panel items can 
also be performed from a tab on this dialog. 


=» Application Launch Bar STO: 


Installed Applications 


> <3 Programming 


Remove 2 
( File Manager PCManFM ~ |b @ intemet 
@ | XTerminal Up > 2 Games 
A 32 1 

%% Mathematica Down b IBS Accessories 
@ Woltram > ¢ Help 

b (® Preferences 

Epiphany Web Browser 


Close 


Above Individual plug-ins can be customised - this is the 
configuration dialog for the application launch bar plug-in 
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HACKING RASPBIAN’S DESKTOP 


THE PANEL FILE 


File Edit Search Options Help 


K lxpanel <profile> config file. Manually editing is not recommended. | 
# Use preference dialog in lxpanel to adjust config when you can. 


Global { 
edge=t an 
allign=left 
margin=0 
widtht ype-percent 
width=100 
height=36 
transparent-—O 
tintcolor=#000000 
alpha=0 
autohide=0 
heightwhenhidden=2 
set dockt ype=1 
setpartialstrut=1 
uscfontcolor=0 
fontsize=12 
fontcolor=#f f ff ff 


Tutorial 


In general, it should not be necessary to edit this file by hand - all 
parameters that you want to set should be modifiable via the relevant 
settings dialogs. If you do edit the file by hand, the changes will only be 
applied to the current desktop if LXPanel is restarted; you can achieve 
this by either rebooting the Pi, or by issuing the following command from 


a terminal window: lxpanelctl restart 


The menu also includes the option to Remove 
<name of plug-in> From Panel - this removes the 
plug-in you right-clicked from the panel, and is 
identical in effect to using the Remove button in the 
dialog box mentioned above. 

Finally, the menu includes the option to Create 
New Panel - this creates a new blank panel on a free 
edge of the screen. This can then be customised by 
right-clicking on the new panel to bring up the same 
menu — but in this case, options selected will affect 
the newly created panel. 


Under the bonnet 


Changes made in these dialogs are stored in the 
LXPanel configuration settings file. This, along with 
various other settings files, is found in the hidden 
-config directory inside your home directory. 

Inside .config/Ixpanel is a directory with the 
name of your current lxsession profile - this is called 
LXDE-pi on a default installation of Raspbian — and 
inside this is a further subdirectory called panels. 
Each file in this directory is the definition of a single 
panel. By default, there is just the one file called 
panel, but if multiple panels are added, there will be 
multiple files in this directory - one per panel. 

The panel file, which can be viewed or changed 
with a text editor, includes an initial Global section 
in which general panel parameters are stored, 
followed by a section for each plug-in. Each Plugin 
section contains a line giving the type of the plug-in, 
followed by a Config section containing parameters 
specific to that plug-in. 


NEXT 
MONTH 


In the next 
part of this 
series, we 


look at how 

to use the 
window 
manager to 
change the 
appearance of 
applications. 
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MARTIN O'HANLON 


Martin ‘Minecraft’ O'Hanlon is an active 
member of the Raspberry Pi community, 
co-author of Adventures in Minecraft, 
and keeps an excellent account of his 
projects on his blog. 
stuffaboutcode.com 


CODING TIPS & TRICKS 


Have you exhausted the Minecraft: Pi basics available from 
raspberrypi.org/resources? Have you completed our tips from issue 31° 
Here are another five tips and mini-programs to experiment with... 


> Raspbian 
> Minecraft: 
Pi Edition 


> Python 2 
editor (IDLE) 


Back up your 
Minecraft worlds as 
acompressed file 


BACK UP AND RESTORE 
MINECRAFT WORLDS 


Ever accidentally set off a load of TNT and wished you 
hadn’t? It’s at times like these it’s a good idea to have 
a backup of your whole Minecraft world so you can 
restore it back to normal. 

Well, you can. Minecraft: Pi Edition stores all of your 
worlds in a directory on your Raspberry Pi’s SD card, 
so by using the terminal and a few commands, you can 
find your favourite world and back it up toa file. Open 
a Terminal window with: 

Menu > Accessories > Terminal. 

Next, change directory to the minecraftWorlds 
directory using the following command: 


cd ~/.minecraft/games/com.mojang/minecraftWorlds 


ls 


tar czf world- -backup.tar.gz world-- 


tar xzf world- -backup.tar.gz 
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cd ~/.minecraft/games/com.mojang/ a 
minecraftwWorlds 


Each world is saved in its own directory and named 
the same as what’s displayed in the Minecraft ‘Select 
World’ screen. Use the 1s terminal command when 
you’re in that directory to see your saved worlds. To 
make a backup of world--, use the tar command to 
create a compressed file: 


tar czf world--backup.tar.gz world-- 


tar is the command, czf tells it to Create a Zipped 
File, world—backup. tar.gz is the name of the backup 
file, and world-- is the directory of the world you 
want to back up. 

Now, the next time you want to restore your world, 
all you have to do is use the following command: 


tar xzf world--backup.tar.gz 


Be warned: once entered, there is no going back! 
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Lid bal bd 


Minecrait— Predrior 


Use torches like a pro, automatically placing them around a block 


USING TORCHES from mcpi import minecraft 


If you want to get some light into your Minecraft world, from mcpi import block 
you need to create torches. You can do so using the 
API, but you need to know how to place the torches mc = minecraft.Minecraft.create() 
around the block you want to attach them to. 
Torches have their own block type and take up an pos = mc.player.getTilePos() 
entire block space in Minecraft (even though it looks 
like they take up a small amount of it), which is why mc.setBlock(pos.x, pos.y + 2, pos.z, block.STONE) 


# create torches 


You could change # on top 


mc.setBlock(pos.x, pos.y + 3, pos.z, block.TORCH) 


the code to make # to the east 


mc.setBlock(pos.x + 1, pos.y + 2, pos.z, block.TORCH) 


a tower of stone eee 


mc.setBlock(pos.x - 1, pos.y + 2, pos.z, block.TORCH) 
# to the north 


you can’t have more than one torch in a block. mc.setBlock(pos.x, pos.y + 2, pos.z - 1, block. TORCH) 
When torches are created using the setBlock() # to the south 
API function, it automatically connects the torch mc.setBlock(pos.x, pos.y + 2, pos.z + 1, block. TORCH) 


to the block which is next to it, to the north, 
south, east, west, or on top. 


Use the following code to create a block of stone You could change the code to make a tower of 
above the player and place torches all around it, stone with torches all around, to provide a beacon to 
and one on top. help you find your way. 
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FIND OUT WHEN BLOCKS ARE HIT SAVE AND RESTORE 


When Steve hits a block by right-clicking with a sword in CHECKPOINTS 


Minecraft, it creates a ‘hit event’; you can get this using Checkpoints let you create in-game mini-backups 
the API and it’!] tell you who hit the block, its position, so you can undo changes that have been made. 
and what face (i.e. top, bottom, left, right) it was hit on. You can use the saveCheckpoint() API function 
You use the function events. pol1BlockHits() to get to make a temporary copy of your world; when you 
a list of events that have occurred since it was last called. use restoreCheckpoint(), this copy is used to 
You can then loop through events using a for loop. put your world back to how it was when you saved 


the checkpoint. 


from mcpi import minecraft 
from mcpi import minecraft 


mc = minecraft.Minecraft.create() 
mc = minecraft.Minecraft.create() 


while True: 


hitsList = mc.events.pollBlockHits() mc.saveCheckpoint() 
for hit in hitsList: 
mc.postToChat("A block was hit (who, S) mc.restoreCheckpoint() 


position, face)") 
mc.postToChat(hit.entityId) 
mc.postToChat(hit.pos) 


mc.postToChat (hit. face) Every 30 seconds, 


your program will 
Start up Minecraft, run the program above, and ' 
experiment with hitting some blocks by holding a sword S a V = a C h (= C k p O l Nn t 


and right-clicking the block. By using the position and 

the getBlock() function, you can find out the type of 

block (e.g. stone, dirt, grass) that was hit: You can use the checkpoint functions to create a 
program which will allow you to ‘undo’ any unwanted 
changes you make to your Minecraft world. Every 30 


blockType = mc.getBlock(hit.pos) seconds, your program will save a checkpoint and if 
mc.postToChat(blockType) you ever want to go back to it, just hit a block. 
Or even better, change the block which was hit, from mcpi import minecraft 
using setBlock() to give Steve the Midas touch and from time import sleep 


make every block he hits turn to gold: 
mc = minecraft.Minecraft.create() 


mc.setBlock(hit.pos, 41) count = @ 


Below Give Steve while True: 


pad pineal Have a think about what other things you can make #every 3@ secs save a checkpoint 
into gold! happen in Minecraft: Pi using block hit events. if count % 30 == @: 


mc. saveCheckpoint() 
mc.postToChat("Checkpoint saved") 


count = count + 1 
sleep(1) 


#if a block is hit, restore checkpoint 
if mc.events.pollBlockHits(): 
mc.restoreCheckpoint() 
mc.postToChat("Restoring checkpoint") 


ff 
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CALCULATING THE DISTANCE 
BETWEEN TWO BLOCKS 


When coding Minecraft, it’s really useful to know the 
distance between two blocks — and by using some 
(fairly) simple maths, we can work it out. This can 
be used in loads of fun ways, such as a hide and seek 
game where a diamond block is hidden and Steve is 
told whether he is getting colder or warmer. 

The maths works like this: 


01 Calculate the difference between the x, y 
& z coordinates of the two positions 


(02) Multiply the difference by itself (its square) 
(03) Add all the squares together 


04) The distance equals the square root 
of the total above 


This program uses this calculation to display how 
far the player is from where they started. So the 
further they move away, the greater the distance. See 
how it works by copying the following code example 
into IDLE or your favourite text editor (don’t forget to 


from mcpi import minecraft 
from math import sqrt 
from time import sleep 
mc = minecraft.Minecraft.create() 
startPos = mc.player.getTilePos() 
while True: 
posNow = mc.player.getTilePos() 
xDiff = startPos.x - posNow.x 
yDiff = startPos.y - posNow.y 
zDiff = startPos.z - posNow.z 
xSquare = xDiff * xDiff 
ySquare = yDiff * yDiff 
zSquare = zDiff * zDiff 
total = xSquare + ySquare + zSquare 
distance = sqrt(total) 


mc.postToChat (distance) 


sleep(1) 


Try changing the program to show the distance between 


save it with the .py file extension): the player and a random diamond block you have created. 
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42 


Free Weaved 
account 
developer. 
weaved.com 


Latest Raspbian 
image 
raspberrypi. 
org/downloads 


APC (Windows, 
Mac, or Linux) 


Internet 
connection 
(for both 
systems) 


MiagPi: May 2015 


SSH Connection Over Internet 


Terminal 
; _ 
(Mac or Linux) 


« 

127 login: pi 

pi@127.0.0.1's password: 

Linux jimfox-rpi0l 3.12.28+ #709 PREEMPT Mon Sep 8 14 


The programs included with the Debian GNU/Linux syst 
the exact distribution terms for each program are de 
individual files in /usr/share/doc/*/copyright. 


iDebian GNU/Linux comes with ABSOLUTELY NO WARRANTY, q 
ipermitted by applicable law. 

Last login: Sat Nov 22 13:05:38 2014 from localhost 
ipi@jimfox-rpioi ~ $ 


SSH ACCESS 
FROM THE WEB 
ON RASPBERRY PI 


SSH into your Pi from anywhere over the internet using Weaved — no need 
for a static IP address, dynamic DNS, or using port forwarding 


SH (Secure Shell) is a powerful tool 

in Raspbian for establishing a secure 

command-line interface between your 
Raspberry Pi and another computer. If you’ve been 
using a Raspberry Pi for a while, you’re probably 
already familiar with SSH as a handy way to 
interact with your Pi in headless mode (without an 
HDMI monitor, keyboard, and mouse). Now, with 
Weaved, you can SSH into your Pi remotely from 
anywhere in the world over the internet, using free 
cloud services and downloadable software. There’s 
no longer any need to reconfigure your router to 
port forward and expose your home network to 
the internet. 


>STEP-01 

Get Weaved 

From any browser, go to developer.weaved.com to 
register for a free Weaved user account. Enter your email 
and create a password for your account, then click ‘Sign 
Up’. You’ll use your Weaved account later to access your 
Pi from anywhere over the internet via SSH. For this 
tutorial, we created an account using the fictitious email 
address MagPiExample@gmail.com. Next, navigate to 
the Weaved Downloads page and click on the Raspberry 
Pi logo. You'll arrive at the Installation Instructions 

for Raspberry Pi webpage - developer.weaved.com/ 
portal/members/betapi.php. Follow the instructions to 
download and run the automated Weaved installer. 
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eee $B Weavad, internet of Thine 


& C 2 hittps://developer. weaved.com/portal/members/home.php 


= Apps GB Evizi Project Mano: 


WEAVED: SSH ACCESS 


Matt 


@ Weaved. 


My Devices My Account Downloads Forum Sign Out 
Welcome magpiexample@gmail.com 
Your current list of devices 
Click on device names to connect. Your account allows for 30 minute connections. 
Name Type Status 
MagPiExample SSH22 Pi Development online at 75.51.151.61/10.0.0.9 Share | Settings 


>STEP-02 

Installing Weaved 

During installation, you will be asked for inputs at 
the command line. Enter 1 at the Protocol Selection 
Menu to select SSH on default port 22. Next, confirm 
your selection and enter your Weaved account email 
and password when prompted for them. You’!1 also 
be asked to enter an alias (a name) for the SSH service 
on your Pi. Later, you will connect over the internet 
via SSH by selecting this name from your Weaved 
device list. In this tutorial, we named the service 
‘MagPiExample SSH’. When installation is complete, 
you’ ll see the CONGRATULATIONS message. 


>STEP-03 

Log in to connect 

Now you’re ready to connect to your Pi via SSH over 
the web. Go to weaved.com from any web browser 
and sign into the account created in step 1. After login, 
you'll see your device list, which now includes the 
newly registered SSH service on your Pi. Give your Pi 
up to 3 minutes to appear as active in your device list, 
from the time the installer finished running in step 2. 


>STEP-04 

SSH over the web 

Click on the SSH service name in the device list. The 
Weaved service will generate a pop-up window with 

a private host name and port number to use for your 
connection. Copy/paste the hostname and port number 
generated by the Weaved service into an SSH client like 
PuTTY (Windows). Or use the SSH command provided 
in a terminal window (Mac/Linux). If you’re typing the 
SSH command ina terminal window, substitute your 
Pi’s local username and the hostname and port number 
generated by the Weaved service, as indicated. Then log 
in with the password from your Raspberry Pi, e.g. user 
‘pi’ and password ‘raspberry’. You will then be logged in! 
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>STEP-05 

Share your Pi 

Now you can share the remote connection services 

on your Pi with other users. Grant temporary, or 

even permanent, access to your Pi to your friends 

and fellow Pi enthusiasts! It’s a convenient way to 

get ‘remote desktop’ help from a more experienced 

Pi user or show off your latest project. Sharing a 
connection service on your Pi with another Weaved 
user is easy. Go to your device list and click Share. Just 
enter your friend’s Weaved account email address and 
click Add. Now, your Pi will appear in their device list 
until you un-share. It’s all under your control. 


>STEP-06 

Get the mobile app 

Download the free Weaved mobile app for iOS or 
Android to enjoy convenient internet access to your Pi 
from your phone or tablet. Log into the app to see your 
device list, then click on the SSH service to connect. 
You’ll need a third-party SSH client app for iOS or 
Android to run the remote client side (phone/tablet) 
of the SSH connection. Then copy/paste the Weaved- 
generated hostname and port number into your SSH 
app, just like you did in step 4. 


7 


% Weaved 
a 


Remote SSH Connection 


MagPiExample SSH22 


Tutorial 


CONNECTION 
TIME 


The Weaved SSH 
hostname and 
port are assigned 


for 30-minute 
sessions. Once 
that time has 
elapsed, you can 
reconnect from 
your device list. 


Left The device list 
shows your devices 
and lets you make 
connections from 
any web browser or 
the Weaved app 


INSTALL 
MULTIPLE 
SERVICES 


Run the installer 
again to enable 


simultaneous 
remote access to 
any combination 
of TCP services 
on your Pi (e.g. 
HTTP, VNC). 


Left Copy/paste 
the hostname and 
port generated by 
the service into 
your SSH client 
(e.g. PUTTY for 
Windows). Or enter 
the full command, 
substituting your 
Pi's username 
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Take control of Curve 
Ball with your own home- 


made controller 


A bit of hacking is needed 
to access the GPIO pins for 


the game controls 


Test your reflexes. How 
fast can you react?! 


CURVE 


Turn Pimoroni’s PiGlow into an interactive game that will test your reactions... 


> Pimoroni PiGlow 


> Small piece 
of stripboard 
(15 < 5 holes) 


> 3x tactile 
switches 
(or similar) 


> Stranded wire 


> Soldering iron 


> Wire cutters 
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hile the PiGlow board does have a library and 

some code examples, it is worth looking into 

how to drive the board directly. These days we 
do beginners a disservice by turning virtually anything 
into a library. This discourages them from actually 
learning how to talk to a device and leaves them trying 
to use library calls that they do not understand. In 
short, it all adds to the fog of what they are trying to do. 


The PiGlow 


The design of the PiGlow board is quite simple: it 
revolves around an SN3218 which is an PC, 18-channel 
LED driver. We’d recommend that you download the 
data sheet and take a look. Now, data sheets can be 
quite intimidating and put us in mind of a small child 
we encountered some years ago, who said, “This book 
tells me more about penguins than I wish to know.” 
Data sheets are the same: there is a lot you simply do 
not need to know, especially if you are looking at how 
to drive a project in a ready-built board. The most 
useful part of any data sheet is the front page — this 

is the headline feature, and then the details of those 
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ETHERNET 


We need to set up a few requirements from the 
command line. Press RETURN after each of the 
following commands and follow instructions 
when prompted: 

sudo apt-get update 

sudo apt-get upgrade 

sudo apt-get dist-upgrade 

sudo apt-get install python-smbus 

sudo apt-get install python-dev 


python-pip 
sudo pip install wiringpi2 


Finally, we need to configure IC: 

sudo raspi-config (enable I?C, make it on by 
default, then select reboot) 

sudo nano /etc/modules (add the line 
i2c-dev to the end of the file, then save it) 
sudo reboot 
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features are contained (somewhere) in the rest of the 
sheet. You will see that it is a constant current driver; 
that means there is no need for any resistors in line 
with the LEDs. Also, the brightness of each LED can be 
individually controlled by means of PWM. This stands 
for ‘pulse-width modulation’ and involves rapidly 
turning the LED on and off; the ratio of the on time to 
the off time determines the LED brightness. The LEDs 
on the PiGlow board are quite bright anyway and you 
may not always want them to go on at full blast. 

Now, commendably, Pimoroni has included all the 
PCB source files, but it still took some time to work out 
where each LED was mounted physically on the board, 
what colour it was, and what channel number of the 
SN3218 it was connected to. All this information was 
extracted and distilled down into Fig 1. As the SN3218 
is an I?C interfaced device, it consists of a number of 
registers, or internal address locations, that control 
the lights. These are shown in the data sheet, starting 
on page 7, and are well worth taking a look at. 


The control registers 

The way this chip works is to have a register that 
sets the duty cycle (the ratio between the on-time 
and off-time) for each of the LEDs. So, that means 
that there are 18 of them, called PWM registers; 
they are numbered @x@1 to @x12 (the ox means what 
follows is a hexadecimal number). Writing a byte 

to those registers will set the brightness of that 
individual LED. However, there will be no change 

in the LED’s brightness until you write to register 
@x16; this is the update register, and transfers the 
levels you set in the PWM registers to the PWM 
circuitry. This means that the code can take its 
time updating the registers, but display them all at 
once. This is important because, as you all know, 
Linux has a habit of timing out your programs at 
unpredictable intervals, and this ‘update all at once’ 
function stops any staggering caused by seeing only 
a partial update. The other registers are used to 
enable the LEDs in three sets of six, set a shutdown, 
or reset the registers back to the default. 


The controls 

Now, to control the game, you need three switches 
attached to the GPIO pins. Tactile switches are best 
because they are dirt cheap; however, for a luxury 

game you can use larger, arcade-type momentary push 
switches, although you’!l have to mount them in a box 
to make them robust. Basically, the circuit is simple: one 
end of a switch goes to a GPIO pin, and the other end to 
ground. In the software, the internal pull-up resistors 
are enabled to give a solid logic 1 when the switch is 

not pressed, and a logic @ when it is. We’re not great 
fans of solderless breadboards for making circuits — the 
problem is that at best it is only a temporary solution, 
but normally you have more trouble with the stability of 
the contacts than it is worth. 
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Fig 1 The PiGlow 
LED colours, 
positions, and 
driver numbers 


The hack 


It is ashame that the PiGlow board only actually 
uses four connections on the 26-way header - all 
the rest are connected, but not used. The answer 
was to single out a small, easy-to-get-at section 
where we could attach wires to the GPIO pins. For 
this, one ground and three GPIO pins were required. 
We decided that the last four connections on the 
far end of the board provided the best spot. A 
photograph of this is shown in Fig 2, overleaf — see 
the boxout for a step-by-step guide to building the 
game. If you are not comfortable, you could always 
use one of Pimoroni’s Black Hat hacker boards to get 
at the GPIO pins you need to use. 


The game 

When you play the game, the flight of the ball will be 
shown as a curved track of the LEDs lighting up one at 
atime. Your job is to hit it; that is, to press the button 
that corresponds to the white bat where the spiral 
path will end up. This is not quite as easy as it sounds. 
Once one button is pressed, the bat lights up and the 
buttons have no effect until the next ball. The sooner 
you press the button, the higher your score will be. If 
you chose the correct bat, then when the ball reaches 
the bat, it goes shooting off along the same path as it 
entered. The trick to the excitement level of the game 
is the speed of the incoming ball: it should not be too 
fast that you don’t have time to press the button, but 
it shouldn’t be much slower than this. 


The code 


The code listing (overleaf) shows a simple version of 
the game with plenty of scope for you to change it. As 
you need direct access to the GPIO pins, you have to 
start IDLE with gksudo idle from the command line. 
The state of the LEDs is held in a list called lights; 
the updateLEDs function transfers this list to the 

PC chip so you can see them. There are a number of 
lists that define pin numbers and LED numbers. The 
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The solder pads 
on the PiGlow are 


tiny. Twist the wire, 
add solder to it, then 
cut it short to make 
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soldering to the 
PiGlow easier 


>STEP-01 


Building the controls 
Take a small piece of stripboard, 15 by 5 holes. Make 


sure the strips are vertical on the back. The dotted lines 
show the copper strips on the other side of the board 
as hidden detail. Mount three tactile switches on the 
board and solder them up. 
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>STEP-02 
Wire up the ground 


The line along the bottom is the common ground that 
links one side of all three switches. The centre switch is 
connected to ground by the wire going down one hole 
and connecting to the next track along, as shown by the 
black dotted line in the diagram. 


triangleTn list is, in fact, a list of lists, giving the 
order of the LEDs in any one spiral. The variables 
speed and returnSpeed control the tempo of the 
game. There are extensive comments and you should 
be able to see what is going on by reading the listing. 
One interesting thing to note is that the main function 
is controlled byatry except structure. This means 
that when CTRL+C is pressed to exit the program, 
there is an opportunity to turn off all the LEDs. 
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>STEP-03 

Attach the wires 

The wires to the PiGlow go through the hole and, 
underneath the board, are bent over to make a connection 
to the track next to it. This is shown as a black dotted line 
in the diagram. They are connected to the PiGlow. 
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>STEP-04 
Connecting to the PiGlow board 


Solder the ends of the wires to the underside of the 


PiGlow board. Make sure the minimum amount of 
insulation is stripped off the wire, to prevent adjacent 
wires shorting. 


You have a go 

The real fun part of any project is when you get to 
change things, to improve it or make it work just the 
way you want it to. Here, we would suggest you first play 
about with the speed variables, and also making the 
time delay before a pitch variable. You can add sound in 
a number of ways; the simplest is by giving a call to the 
omxplayer to play a sound when a hit is detected. 

You could extend the game to keep a running score 
and have a ‘three strikes and you’re out’ rule. You 
change which switch controls which bat by simply 
shuffling or redefining the pinList list. You could keep 
a high score, and break into some pyrotechnic displays 
on the LEDs when a new high score is generated. 

Another idea is to turn the game on its head and call 
it ‘Down The Plughole’! You have to stop the bath from 
overflowing by pressing the switch corresponding to a 
single light on the PiGlow. Get it wrong and all the lights 
on that ring light up. One final hardware improvement 
is to simply put a square of paper over the PiGlow board; 
this stops the glare and makes the colours look richer. 


raspberrypi.org/magpi 


Curve'Ball.py 


Q1. 
@2. 
3. 
4. 
OS. 
06. 
07. 


08. 
e9. 
10. 
afi he 
as 
dss 
14. 
alive 
16. 
7/6 
18. 
aly 
20. 
21% 
220 
23% 
24. 
2D. 
26. 
275s 
28. 
29. 
30. 
e}ilie 
32) 
B35 


# Curve Ball - a game for the PiGlow board 
# By Mike Cook - March 2015 

import time, random, sys 

from smbus import SMBus 

import wiringpi2 as io 


# command register addresses for 
the SN3218 IC used in PiGlow 
CMD_ENABLE_OUTPUT = @x00 
CMD_ENABLE_LEDS = 0x13 
CMD_SET_PWM_VALUES = @x@1 
CMD_UPDATE = 0x16 
SN3218 = 0x54 # i2c address of SN3218 IC 
bus = None 
trys: 
io.wiringPiSetupGpio() 
except : 
print"start IDLE with 'gksudo idle’ from terminal" 
sys.exit() 


pinList= [7,8,25] # GPIO pins for switches 


lights = [@x@e@ for i in range(@,18)] #LED brightness list 
red = [0,6,17] # red LEDs 

orange = [1,7,16] # orange LEDs 

yellow = [2,8,15] # yellow LEDs 

green = [3,5,13] +# green LEDs 

blue = [14,4,11] # blue LEDs 

white = [12,9,10] # white LEDs 

triangleIn = [red,orange, yellow, green, blue,white] 
triangleOut = [white, blue, green, yellow, orange, red] 


speed = 0.03 # delay is twice this 
returnSpeed = @.1 # for hit back 


score = 0 
def main(): 
initGPIO() 
busInit() 
while True: # repeat forever 
wipe() 
updateLEDs (lights) 
while scanSwitches() != -1: #make sure fingers off 
pass 
pitch() 


def pitch(): # throw the ball 
global score 
time.sleep(1.0) # delay before the throw 
# try making this random 
arm = random.randint(@,2) # direction of curve ball 
bat = False 
push = -1 
for triangle in range(@,5): 
wipe() # clear all LEDs in the list 
if bat: 
lights[white[push]] = @x2@ # turn on bat LED 
lights[triangleIn[triangle][arm]] = @x8e 
updateLEDs (lights) 
time.sleep(speed) 
if not bat: # no switch pressed yet - look for one 
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>PYTHON 


push = scanSwitches() # switch pressed? 
if push != -1: 
bat = True # no more looking at switches 
score = 6 - triangle # sooner you see 
# it the higher the score 
else: 
lights[white[push]] = x20 
updateLEDs(lights) 
time.sleep(speed) 
if arm == push: 
print "hit - score ",score 
for triangle in range(@,6): 
wipe() 
lights[triangleOut[triangle][arm]] = x8e 
updateLEDs(lights) 
time.sleep(returnSpeed) 
time.sleep(@.7) 


# hit it back 


def initGPIO(): # set up the GPIO pins 
for pin in range (0,3): 
io.pinMode(pinList[pin],®) # make pin into an input 
io.pullUpDnControl(pinList[pin],2) # enable pull up 


def scanSwitches(): # look at each pin in turn 
down = -1 # default return value means no switch pressed 
for pin in range (0,3): 
if io.digitalRead(pinList[pin]) == 0: 
down = pin 
return down 


def busInit(): # start up the I2C bus and enable 
# the outputs on the SN3218 
global bus 
bus = SMBus(1) 
bus.write_byte_data(SN3218,CMD_ENABLE OUTPUT, @x01) 
bus.write_i2c_block_data(SN3218, CMD_ENABLE_LEDS, 
[OxFF, @xFF, @xFF]) 


def updateLEDs(lights): # update the LEDs to 

# reflect the lights list 
bus.write_i2c_block_data(SN3218, 

CMD_SET_PWM VALUES, lights) é 
bus.write_byte_data(SN3218,CMD_UPDATE, @xFF) 


def wipe(): # clear the lights list 
global lights 
for i in range(0,18): 
lights[i] = 2 


NEXT 
MONTH 


if _name_ == '_ main_': 
LYE In next month's 
: Pi Bakery, 
main 
ne) Mike looks at 
except KeyboardInterrupt: a novel way of 
# set all the LEDs to "off" detecting toy 
# when Ctrl+C is pressed cars and builds 
# before exiting a wildlife Safari 
A Park game. 
wipe() 
updateLEDs(lights) 
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KEYBOARD & MOUSE 


In the third part of this series, we write some code to get to grips 
with using our keyboard and mouse with Python and Pygame 


QUICK TIP 


Pygame has a set 
of handy built-in 
variables for 
checking which 


keys are pressed. 
We've only used 
a couple, but 
you can find the 
complete list at 
pygame.org via: 
bit.ly/1ycZt2i 
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n the first couple of tutorials, we got to grips 
with the core concepts of drawing and moving 
shapes of all types, sizes and colours with 
Pygame. Now that we know our way around Pygame, 
we’ re going to start making things that we can play 
with that are a little more interactive. This time, we’re 
going to make two simple programs to learn how to use 
our keyboard and mouse. Our first program will use the 
keyboard; with it, we’ll draw a red square and give it 
some code so it can move left and right and jump, which 
may conjure memories of a certain, heroic plumber. Our 
second program will use the mouse. Again, we’ll create 
a Square that we can pick up, drag around and, when we 
let go of our mouse button, will drop to the floor with 
the help of a little Pygame-programmed gravity. We’re 
focusing on game dynamics for the time-being — we’ ll 
make prettier things later, we promise. 

So, on to our first program - keyboard.py. Unlike 
last time, we’ re not going to be chopping and changing 
bits of code to affect the program. If you copy out 
keyboard.py and run it on your Raspberry Pi, it’ll run 


just as we intend it to. This time, we’re going to walk 
through the code line by line to understand exactly 
what each bit does for the program. Like a lot of things 
in computing, let’s start at the top! The first 12 lines of 
code on the next spread should look pretty familiar to 
you by now; these are the variables we’ve used in the 
previous two parts to define how our window should 
look, and how we want to interact with Pygame and its 
methods. The next dozen or so lines are variables that 
we’ll use to determine how our keyboard-controlled 
square should look and where it should be. Following 
that, we have two functions, move() and quitGame(), 
which we’ll use to move and quit the game. Finally, just 
as in the previous tutorial, we have our main loop where 
we update our game and redraw all of our pixels. 


What keys have we pressed? 

How do we know what keys are pressed and when: In the 
last issue, we imported pygame. events as GAME_EVENTS; 
now we get to use it. Every Pygame program we write 

is one big loop that keeps on running forever or until 
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we exit the program. Every time our loop runs, Pygame 
creates a list of events that have occurred since the last 
time the loop ran. This includes system events, like a 
QUIT signal; mouse events, such as a left button click; 
and keyboard events, like when a button is pressed or 
released. Once we have the list of events that Pygame 
received, we can decide how our program should respond 
to those events. If the user tried to quit, we could save 
the game progress and close the window rather than just 
exiting the program, or we could move a character every 
time a key has been pressed. And that’s exactly what 
keyboard.py does. 

On line 85, we create a for loop that will work through 
each event in the list that Pygame created for us. The 
events are arranged in the list in the order that Pygame 


Once we have the list of events that 
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to check whether or not any of the key presses are keys 
that we’re looking for. 

Once we know that a key has been pressed and which 
key it was, we can then write code to affect our program 
in specific ways. For example, if the left arrow key has 
been pressed, we can move our player to the left with 
playerX -= 5, but we haven’t done that here. Why 
not? Pygame doesn’t emit duplicate events for key 
presses, so if we hold down a key to keep our square 
moving to the left, nothing would happen. Our square 
would move the first time Pygame detected the key 
press, but then it would stop until we pushed the 
button again. This is intended to help prevent situations 
where multiple key presses could glitch our games or 
give a player an unfair advantage, but it doesn’t help 


QUICK TIP 


The X and Y 
coordinates of a 


mouse are relative 
to the left and top 
of the window, not 
the screen that 
it'sin. 


Pygame received, we can decide how our 
program should respond to those events 


received them. So, for example, if we wanted to use the 
keyboard events to type in our player’s name, we could 
trust that we would get all of the letters in the right order 
and not just arandom scramble of letters. Now that we 
have a list of events, we can work through them and 
check if certain events that are relevant to our game have 
happened. In keyboard.py, we’re primarily looking for 
keyboard events; we can check whether or not an event 
is a keyboard event by checking its ‘type’ property with 
event. type. If our event.type is a pygame . KEYDOWN 
event, we know that a key has been pressed; if our 
event.type is a pygame. KEYUP event, we know that a key 
has been released. We look for KEYDOWN events on line 87 
and KEYUP events on line 93. We look for KEYDOWN events 
first because logic dictates it — you’ve got to press a key 
down before it can pop back up again! 

We know have a way of knowing if a key has been 
pressed, but how do we know which key our player 
pressed? Every Pygame key event has a ‘key’ property 
that describes which key it represents. If we were to print 
out the event. key property, we would see a bunch of 
numbers, but they aren’t the keys that we pressed! The 
numbers we would see are key codes; they’re numbers 
that are uniquely tied to each key on your keyboard, and 
programmers can use them to check which keys they 
represent. For example, the ESC key on your keyboard 
is 27, the A key is 97, and the RETURN key is 13. Does 
this mean that we have to remember a seemingly 
disconnected bunch of numbers when we’re writing 
keyboard code? Fortunately, the answer is no. Pygame 
has a ton of values for checking key codes, which are 
easier to read and remember when we’ re writing code. 
On lines 89, 91, 93, and 97, we use pygame.K_LEFT, 
pygame.K_RIGHT, pygame.K_UP, and pygame.K_ESCAPE 
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us very much when it comes to creating games with 
smooth movement. So how do we get around this? 
Every time we detect a key press, instead of taking an 
action, such as moving our square, we set a variable 
instead. The variables leftDown, rightDown, and 
haveJumped are the variables that we can use to describe 
the key states (up or down) to the rest of our program. 
Whenever we detect that the left arrow button has been 
pressed, we set leftDown to True; if we detect that the 
left arrow button has been released, we set leftDown to 
False. If our player holds down the key, leftDown will 
always be True, so we can make our Pygame program 
keep moving our square smoothly across the screen, 
even though it’s not receiving a constant barrage of 
events telling it to do so. 


Move() 


Just after our key detection code we have line 111, which 
simply has move() on it. This is a function call. Before 
now, almost all of the code we’ve written has been 
inside our main loop. The problem is that after a while, 
having every single line of code in one big loop can get 
a little messy and hard to follow. So, to make our lives 
easier, we’ve put the code that’s responsible for making 
our character move into its own function, the move 
function. When we call move(), a lot of code then runs. 
So let’s take a look at what’s going on... 

On line 31 we have a global statement. Because our 
code is inside the move() function, it no longer has 
the same scope as our for loop. Although we can look 
at the values of variables outside of our function, we 
can’t set them, unless we include them in the global 
statement. This tells Python that when we call playerx, 
for example, we definitely mean the playerxX at the top 
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Global Scope 


banana = 5.0 


def move(): 


print banana 


50 


>> 5.0 
AboveAbasic Of the file - not anew playerxX that we might create 
iWustrationof within the function, 
code scope 
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Lines 34 to 50 are where we make our little square 
move left or right, depending on the buttons that have 
been pressed. If the left arrow button is down, we want 
to move the square/character/object to the left. This is 
what we’re doing between lines 36 and 41. To do this 
convincingly, we first need to check whether or not our 
square is moving already and the direction it’s going 
in. If our square is already travelling to the right, we 
need to make it stop and then change direction. Think 
about it: if you’re running ina straight line, you can’t 
turn right around and keep running at the same speed 
— you need to stop, turn, and then build the speed up 
again. Line 37 checks whether our square’s X velocity is 
over 0.0 (going to the right). If it’s not, then we either 
don’t need to move at all, or we’re already moving to 
the left, so we can just keep on moving. But if we are 
moving to the right, setting playerVX to moveSpeed 
and then inverting it will stop our square and send it in 
the correct direction. We don’t want our square to run 
off the screen either; lines 40 and 41 stop our square 
moving if it’s at the left edge of our screen. Lines 44-50 
do the exact same thing but in reverse. 

Lines 52-70 are a little different. It’s here that we add 
gravity to our square’s movement. When we hit the up 
arrow on our keyboard, our box jumps, but what goes 
up must come down. Just like when we change direction 
when we run, we need to slow down after jumping 
before we start to fall back down again. That’s what’s 
going on here. First, on line 52, we check to see whether 
our square is travelling upwards at a speed greater 
than 1 pixel per frame. If it is, then we multiply that 


value by 0.9 so it will eventually come to a point where 

it is travelling less than 1 pixel per second; when that 
happens, we set the value to 0 so that we can start falling 
back to the bottom of the screen. Next, our code checks 
whether our square is in the air — it can’t stay up there all 
day! On lines 59-61, we check that the square is in the air 
and then start adding the gravity value to the playerVY 
value; this will make our square move back down to the 
bottom of the screen. Each time we add the gravity 
value to the playerVY value, we multiply the former by 
1.1; this makes the square speed up as it falls back to the 
bottom of the screen, just like it would if you threw a ball 
in the air. Lines 63-64 reset the gravity and playerVY 
values when the bottom of the square hits the bottom 

of the screen. Lines 68-70 are fun, in that they stop the 
square from moving any faster left or right once our 
square has jumped in the air. You can’t change direction 
after you jump; you can only change direction when you 
hit the ground again, so that’s what our square does too. 


Pygame mouse events 
That’s enough of the keyboard for now; it’s time for 
the mouse to shine. The mouse is a simple bit of kit, so 
the code for it is far less complicated than our keyboard 
code. If you copy out mouse.py and run it, you’ll seea 
familiar fetching red square sitting at the bottom of the 
screen. Pressing your keyboard keys will do nothing this 
time, for this square is different. If you want to move 
it, you’ve got to pick it up! Drag your mouse over the 
square, hold down the left mouse button and drag up. 
Our square moves with our mouse. If you let go of your 
mouse button, the square will fall back to the bottom of 
the window. Nice and simple, but how does it work? 
This time, we have hardly any code at all in our main 
for loop. Here we’re only checking whether or not the 
first mouse button has been pressed and then we call 
three functions: checkBounds(), checkGravity(), and 
drawSquare( ). In our keyboard.py code, we put some of 
our code into functions; this time we’ re doing it to all of 
them, but we’ll get to those in a bit. 


Jump = (VY + 25) 


Jump = Y + (1* 1,1) 


Above An example of gravity working against a Y velocity 
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heyboard.py 


e1. 
@2. 
3. 
04. 
@5. 
06. 
Q7. 
08. 
e9. 
10. 
tlie 


128 
13 
14. 
ileye 
Ge 
il7fe 
18. 
193 
20. 
2a 
220 
23% 
24. 
25. 
26. 
27s 
23% 
298 
307 
30. 


B2e 
330 
34. 
35. 


36. 
Bie 
ish 
BOF 


40. 
41. 
42. 
43. 
44. 
45. 


46. 
47. 
48. 


49. 
50. 
Die 
Bye 
Sie 
54. 
Spi 
56. 
57. 


import pygame, sys 
import pygame.locals as GAME_GLOBALS 
import pygame.event as GAME_EVENTS 


# Pygame Variables 
pygame. init() 


windowWidth = 800 
windowHeight = 80 


surface = pygame.display.set_mode((windowWidth, 
windowHeight) ) 
pygame.display.set_caption('Pygaiie Keyboard!) 


# Square Variables 

playerSize = 20 

playerX = (windowWidth / 2) - (playerSize / 2) 
playerY = windowHeight - playerSize 

playerVX = 1.0 
playerVY = 0.0 
jumpHeight = 2 
moveSpeed = 1. 
maxSpeed = 10. 
gravity = 1.0 


Bo) 
4) 
2) 


# Keyboard Variables 
leftDown = False 
rightDown = False 
haveJumped = False 


def move(): 
global playerX, playerY, playerVX, playerVy, 
haveJumped, gravity 


# Move left 
if leftDown: 
#If we’re already moving to the right, reset the 
# moving speed and invert the direction 
if playerVX > @.0: 
playerVX = moveSpeed 
playerVX = -playerVXx 
# Make sure our square doesn’t leave our 
# window to the left 
if playerX > @: 
playerX += playervVXxX 


# Move right 
if rightDown: 
# If we’re already moving to the left reset 
# the moving speed again 
if playerVXx < 0.0: 
playerVX = moveSpeed 
# Make sure our square doesn’t leave our 
# window to the right 
if playerX + playerSize < windowWidth: 
playerX += playerVXxX 


if playervy > 1.0: 

playerVY = playervY * 0.9 
else: 

playerVY = 0.0 

haveJumped = False 
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qanquage 


>PYTHON 


# Is our square in the air? Better add some gravity 


# to bring it back down! 
if playerY < windowHeight - playerSize: 
playerY += gravity 
gravity = gravity * 1.1 
else: 
playerY = windowHeight - playerSize 
gravity = 1.0 


playerY -= playervY 


if (playerVX > @.@ and playerVX < maxSpeed) or 

(playerVX < @.@ and playerVX > -maxSpeed): d 

if not haveJumped and (leftDown or rightDown) 
playerVX = playerVX * 1.1 


# How to quit our program 
def quitGame(): 


pygame. quit() 
sys.exit() 


while True: 
surface.fill((0,8,0)) 


pygame.draw.rect(surface, (255,0,0), 
(playerX, playerY, playerSize, playerSize)) 


# Get a list of all events that happened since 
# the last redraw 
for event in GAME_EVENTS.get(): 


if event.type == pygame.KEYDOWN: 


if event.key == pygame.K_LEFT: 
leftDown = True 
if event.key == pygame.K_RIGHT: 
rightDown = True 
if event.key == pygame.K_UP: 
if not haveJumped: 
haveJumped = True 
playerVY += jumpHeight 
if event.key == pygame.K_ESCAPE: 
quitGame() 


if event.type == pygame.KEYUP: 
if event.key == pygame.K_LEFT: 
leftDown = False 
playerVX = moveSpeed 
if event.key == pygame.K_RIGHT: 
rightDown = False 
playerVX = moveSpeed 


if event.type == GAME_GLOBALS.QUIT: 
quitGame() 


move() 


pygame.display.update() 
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Tutorial 


playerVX = 1.0 playerVX = 5.0 playerVX = 15.0 
Above The two important things we need to know when 
Ademonstration of 


the varying effects 
of the X velocity 
when jumping 


Below An illustration 
of checking the box 
bounds against the 
cursor coordinates 
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using a mouse are where it is and which buttons, if 
any, have been pressed. Once we know these two 
things, we can make stuff do stuff, and we all love 
making stuff do stuff. First, we’re going to find out 
where the mouse is, and we do that on line 76 with 
pygame.mouse.get_pos(). Unlike our keyboard, we 
don’t have to work through a list of events and check 
whether they were mouse events. Instead, when we 
call pygame.mouse.get_pos() we get a tuple back 
with two values: the current X and Y value of the 
mouse inside the window. Great, we know where the 
mouse is; all we need to know now is whether or not 
any of the buttons have been pressed and we do this 
on line 81. pygame.mouse. get_pressed() returns 

a tuple of three values: the first is for the left mouse 
button, the second for the middle mouse button, 

and the third for the right mouse button. If the 
button is pressed down, then the value is True, 
otherwise it’s False. We’re not doing anything 

with the middle or right mouse button, so we can 
simply check the first value (the left mouse button) 
with pygame.mouse.get_pressed()[0]. Now, if 
pygame .mouse.get_pressed()[@] is True, then our 
player has clicked a button and we can do stuff. In this 
case we set mousePressed to True, just as we did with 
leftDown and rightDown in keyboard.py, so we can 
use it throughout our program. 


Not within 


box bounds 


Checking the square 

Now that we know where our mouse is and which 
buttons are pressed, we can do something with that 
information. Straight after our code that checks our 
mouse buttons, we call checkBounds() on line 86. 
checkBounds() has one job: to check whether or not 
our mouse position is within the bounds (edges) of 
our square. If we were making a fully fledged game, 
this function would likely check the position of every 
game object against the mouse coordinates, but in this 
example we’re only looking at our lovely red square. 
Line 31 checks whether or not our mouse button has 
been pressed — after all, there’s no point in checking 
where our mouse is if it’s not doing anything. If our 
mouse button has been pressed, on line 33 we look at 
where the X coordinate of the mouse is and compare 
it to the X coordinate of our square. If our mouse X 

is greater than the left of our square and is smaller 
than the X value of the right of our square (squareX 

+ squareSize), we know that our mouse is within 
the X bounds of our square, but that doesn’t mean 
that it’s inside our shape. Before we do anything with 
our mouse, we need to check that the Y coordinate 

of our mouse is within our square too, which we do 
on line 35. If the Y value of our mouse is greater than 
the top of our shape and less than the bottom of it, 
then we can be certain that our mouse is somewhere 
inside of our shape. In mouse.py, we’ve checked 

the X coordinates and Y coordinates on separate 

lines — we could have done it on one, but it’s quite an 
intimidating line to read, let alone write! Now that we 
know our mouse is positioned within our square and 
that we’ve pressed our mouse button, we can set our 
draggingSquare variable to True. 

Once checkBounds() has done its job, 
checkGravity() gets to work. Just like in 
keyboard.py, checkGravity() looks at where our 
square is in the window and if it’s not on the bottom of 
our window, it will accelerate our square to the bottom. 
However, it will only do this if we’ve let go of our 
mouse button, because we don’t want our shape to fall 
to the ground when we’re holding onto it. 

Our final function is drawSquare() — five Pygame 
points if you can guess what it does... Based on the 
adjustments of checkBounds() and checkGravity(), 
drawSquare() will draw our square (did you manage 
to guess°). If our square is being dragged around 
by our mouse, it will draw the square at the mouse 
coordinates. But if we aren’t dragging it around, it will 
draw a graceful gravity-driven descent back to the 
bottom of our window. drawSquare() has one little 
trick up its sleeve: as well as affecting the position of 
our square, it also changes its colour - red when not 
being dragged and green when being dragged. This 
code could be useful if we had a little character and we 
wanted to change his graphic to make it look like he 
was holding onto our cursor. 
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Mouse.py {a g d # Is our square in the air and have we let go of it? 


>PYTHON if squareY < windowHeight - squareSize and .) 
2 mousePressed == False: 

Q@1. import pygame, sys squareY += gravity 
Q@2. import pygame.locals as GAME_GLOBALS 52 gravity = gravity * 1.1 
@3. import pygame.event as GAME_EVENTS 53. pile 
ae . 54. squareY = windowHeight - squareSize 
@5. # Pygame Variables 55 gravity = 5.0 
06. pygame.init() er. : 
oe ; i 57. def drawSquare(): 
Q8. windowWidth = 800 58 
a ENTS FeV ESN Shc BOF global squareColor, squareX, squareY, draggingSquare 

68. 
11. surface = pygame.display.set_mode((windowWidth, .) 61 if draggingSquare == True: 

windowHe ight) ) oo . 

we ; ’ . , 63. squareColor = (@, 255, @) 
Ee Pye ame tle play es cape ton( Fyeane ouee) 64. SquareX = mousePosition[@] - squareSize / 2 
ae F . 65. sSquareY = mousePosition[1] - squareSize / 2 
15. # Mouse Variables 66 
Lessee te once Gi pygame.draw.rect(surface, squareColor, 
ace oe pee Set 3a 2c (squareX, squareY, squareSize, squareSize) ) 

Es 68. 


19. # Square Variables 
20. squareSize = 40 
21. squareColor = (255, @, @) 


69. # How to quit our program 
70. def quitGame(): 


ike ame.quit 

22. squareX = windowWidth / 2 72 ae Loe 0) 
23. squareY = windowHeight - squareSize oe : 
24. draggingSquare = False 7A. aie TRUE: 

gravity = 5.0 75. ¥ 
vas 76. mousePosition = ame.mouse.get_pos 
27. def checkBounds(): == PY6 get_pos() 
200 z 78. surface.fill((9,0,9)) 
29. global squareColor, squareX, squareY, draggingSquare 79 
ae if p 4 ; ; 80. # Check whether mouse is pressed down 

. By OUe Gia ot Tiny Ue 81. if pygame.mouse.get_pressed()[@] == True: 

B2e # Is our cursor over our square? 32 TRVECDROSEEN = True 
33% if mousePosition[@] > squareX and ) 83. ellees 

mousePosition[@] < squareX + squareSize: an PAncepnaeced eeiaa 
34. oa 
On if mousePosition[1] > squareY and J 86. checkBounds() 

mousePosition[1] < squareY + squareSize: 87. checkGravity() 
oe ‘ 88. drawSquare() 
Bie draggingSquare = True 39 
38. pygame.mouse.set_visible(0) 90. pygame.display.update() 
Bor 91 
pe SES 92. for event in GAME_EVENTS.get(): 
Ade squareColor = (255,0,@) 93 oa 
es Syfelilee ese atse MeN ole) 94. if event.type == pygame.KEYDOWN: 
ae GD EIJEMIE CRISIS = 5c oor if event.key == pygame.K_ESCAPE: 

i ; 96. quitGame() 

45. def checkGravity(): 97 
ade ; . ; ; 98. if event.type == GAME_GLOBALS.QUIT: 
47. global gravity, squareY, squareSize, windowHeight ae quitGame() oe 
48. at 


WHAT WE'VE LEARNED 


We've learned that Pygame creates a list of events learned that we can get mouse events whenever 
that occurred every time the frame is updated, and we like, and that we can get coordinates of where 


that we can work through them to check for events the mouse is and which buttons are pressed. We've 
that we want to use. We learned that Pygame learned how to simulate gravity and jumping, and 
receives key codes when buttons are pressed, but we've made ourselves think about how things move in 
has a big list of key code events that we can use so the real world too. Congratulations, we now have the 
we don't have to remember all of the numbers. We beginnings of a real game. 
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RASPBERRY PI 


Raspberry Pi blogger Richard Waterworth compares four of our favourite B+ and 
Raspberry Pi 2 Model B-compatible cases to see which one comes out on top... 


54 


The Short Crust Plus is a fairly minimal 
Raspberry Pi case. It comes in two different 
colour options for the base (black and white), 
and this allows you to alter the overall look. 
The top of the case is a smooth glossy finish, 
which can turn into a fingerprint magnet, 
but it’s easily cleaned. The main base of 

the case is a rougher matte finish, which 
compliments the top perfectly. 


MagPi May 2015 


The Short Crust Plus offers plenty of 
ventilation on the bottom of the case, and 
the release trigger (also found underneath) 
allows you to easily remove your Pi. In 
terms of cost, the Short Crust is reasonable 
considering the high-quality plastic used. 
It also comes with non-slip rubber feet and 
screw holes in the base, should you wish to 
mount it under a desk or ona wall. 


If you're Looking for a cleanly 
designed, modern-looking 
case with all the mod- 

cons, you should definitely 


consider the Short Crust Plus. 


Score Kk kkk 
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RASPBERRY PI CAS 


mr 


S 


HELIX PIBOW FLIRC 
CASE COUPE PI CASE 


The Pibow Coupé offers a 

very slimline design. Unlike 
conventional cases, the Coupé does 
not fully cover the entire Pi, only 
its sides and bottom, allowing the 
USB and Ethernet ports to protrude 
from the top of the case. In typical 
Pimoroni style, it’s constructed 
from thin layers of plastic and 
comes in a variety of colours. 


The Helix is no ordinary Raspberry While we weren’t sure about the The Flirc Case has a very solid 
Pi case. It’s made from MDF and look of Coupé at first, it quickly grew construction as it’s made froma 
features a flexible ‘shell’ around on us during testing, though we solid aluminium shell with a matte, 
its core. The quality of the case is wouldn’t use it for a home theatre rubberised plastic top and base. 
impressive for the price. However, setup. For us it’?d be much more The aluminium finish gives the case a 
if you are disassembling it you’ ll at home as a second computer or premium feel, too, which is always a 
need to be careful, as some elements slimline project case, though you bonus. Unlike the other cases on test, 
of the case are quite fragile. Once might disagree. Most importantly, it comes with a built-in heatsink. 
you’ve installed your Pi in the Helix, however, the Coupé provides It’s easy to put together, using four 
though, it looks great, and quite easy access to all ports, which is screws to secure it. 
unlike the vast majority of cases on especially useful for people who It’s certainly not as prone to 
offer elsewhere. will be using the Camera module or fingerprints as the Short Crust Plus, 
Inside the case, there are some tinkering with components attached but it does smudge, which is only 
supports that your Raspberry Pi sits to the GPIO ports. really noticeable up close. The Flirc 
on, but there’s nothing on the top is primarily advertised as ahome 


of the Pi to hold it securely in place. 
Given the asking price (it’s the 
cheapest on test), we can’t be too 
harsh, but we can’t help but think 
if the pins holding the ‘shell’ of the you can afford it, the cost is . 
case were a bit bigger and there were easily justified considering GZ 
a few more supports to hold the Pi, the materials used in -@ 

this could be a really great case. its construction. 


theatre case for the Raspberry Pi, 
but it’s likely to be at home in other 
environments, too. It’s the most 
expensive case on test but if 


The Pibow Coupé has sucha The Flirc is a very 

distinctive look, you'll probably love clean and simply designed 

it or hate it. Either way, it’s a great case for your Raspberry Pi. 

case for people who want to use their It looks sleek and feels premium, 
Raspberry Pi for hardware projects. thanks to its aluminium finish. 


The ModMyPi Helix might not be 
for everyone, but if you want to 
set yourself apart and don't have 
a great deal of money to spend, 
this is definitely the case for you. 


Score Score Score 
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Maker 
says 


Bring 


your Raspberry 


Pj into the 


physical world 


Seeed 


GROVEPI+ STARTER KIT 


GROVEPI+ STARTER KIT 


Gareth Halfacree finds out if the GrovePi+ kit really can make 
experimentation as simple as plug-and-play for electronics newcomers 


ARDX 
ARDUINO 
STARTER 
KIT 


A fully featured 
starter kit for the 
Arduino Uno, 
complete with 
numerous well- 
documented 
projects, the 
ARDX can bea 
handy accessory 
for any computer 
- including the 
Raspberry Pi. 


£62 /$85 
oomlout.co.uk 
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he GrovePi+ is positioned 

as a kit that makes it as 

easy as possible to get 
started with electronics projects, 
and yet offers considerable 
flexibility and power. Packaged in 
the same eye-catching green carry- 
case as Seeed Studio’s other Grove 
kits, the GrovePi+ includes the main 
board plus 12 modules: sensors 
for sound, light, angle, distance, 
and combined temperature and 
humidity; red, blue, and green 
LEDs; buzzer; character-based LCD 
display with RGB LED backlight; 
button; and relay. 


Fit to burst 

It’s pretty packed, in other words, 
and the small amount of free 
space in the box is taken up with 
a handy 30-page guidebook. 
Printed in full colour, the booklet 
walks you through getting started 
and includes several example 
projects using the bundled 
hardware. These range from 
making an LED blink, through to 
posting multiple sensor readouts 


to Twitter, and are a good source 
of inspiration. 

The GrovePi+ board itself can 
be thought of as a customised 
Arduino, using the same ATmega328 
microcontroller to provide 
capabilities beyond a normal 
Raspberry Pi: three analogue 
inputs, seven digital input/ 
outputs, three 12C connections, 
and serial connectivity to both the 
microcontroller and the Pi itself. The 
GPIO pins are even brought through 
and free for use, although these are 
limited to the 28 pins of the original 
design rather than the extended 
40-pin header of the Plus or 
Raspberry Pi 2 models, with which 
the GrovePi+ is fully compatible. 


Clever script 

Installation is relatively 
straightforward, using either a 
Dexter Industries customised 
Raspbian download or a two- 
step customisation process for 
existing Raspbian installations. 
A clever script takes care of the 
more complicated steps - such as 


enabling I2C communication and 
disabling the Linux serial console 
- although during testing, it failed 
to register the GrovePi Python 
library correctly, requiring a final 
manual installation step that the 
documentation did not mention. 
Once installed, a wealth of Python 
examples are provided. These range 
from simple programs to make a 
buzzer sound, through to the more 
complicated projects detailed in the 
bundled manual. Sadly, these stand 
alone: despite claims of support for 
the C language, no library or examples 
are yet available, with the project’s 
maintainers citing a lack of demand. 


{ast word 


If you're a Python fan looking 
to branch into electronics, 
the GrovePit is a great choice 


and won't rob you of all your 
GPIO headers. The team has, 
however, failed to deliver on 
its C promise. 
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LER HAT 


Maker 
says 
It will get 
you flying 
in the world 
of micro- 


controllers 
Pimoroni 


PROPELLER H 


Les Pounder delves into the world of multi-core micro 
controllers, courtesy of Pimoroni’s latest board 


RASPIO 
DUINO 


We awarded 
this four stars 
in issue 31. The 
Duino merges 
Arduino and 
Raspberry Pi 
worlds into one 
handy platform 
and is useful 
for a multitude 
of projects. 


£12 /$18 
rasp.io/duino 
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uite often, electronics 

projects require split- 

second precision. 
Since this isn’t the Raspberry Pi’s 
forte, you’d normally use a small 
microcontroller, like an Arduino 
or the Parallax Propeller. 

With the Propeller HAT, 

Pimoroni has placed the Parallax 
microcontroller on a HAT add-on 
board, along with a handy 
170-point breadboard to help 
you rapidly prototype projects. 
The Propeller HAT - a completely 
open-source hardware and 
software platform, based upon 
the Parallax Propeller 1 P8X32A 
— comes partially built, requiring 
a little soldering to populate 
the pin headers that you can see 
around the board. In total there 
are 30 pins, labelled Ao to A29. 
To the left and right of the board, 
you can see some of the standard 
Raspberry Pi GPIO pins broken 
out for use too, including pins 
for IC and SPI. 


SPIN it 

The Parallax Propeller at the 
heart of the Propeller HAT 

can be programmed using the 
PropellerIDE, which creates files 
in a language called SPIN. Once 
you have written your project, 

it isa simple matter of clicking 
‘Run’ in the IDE to create a binary 
file and then uploading the file to 
the board. It’s a similar process 
to the Arduino, where code is 
compiled and then uploaded to 
be run. Binary files can also be 
uploaded to the board using the 
piload command in the terminal, 
enabling fast upload of pre- 
compiled projects. To round off 
the software, there’s also an 
excellent Python library that 
enables you to create scripts to 
control the Propeller HAT 

with Python. 

Elsewhere, the Propeller 

HAT can emulate the SID chip, 
commonly found in Commodore 
64 and 128 8-bit machines from 


the 1980s, enabling your projects 
to output SID music via a 3.5mm 
jack attached to the breadboard. 


Is it right for you? 

You might be wondering who 
this board is for. If you are just 
starting your journey into the 
world of hardware hacking and 
making, then this is not for you. 
But if you are an experienced 
hacker, this is a great place to 
learn more about multi-core 
microcontrollers, and generally 
have a lot of fun hacking and 
making on your Raspberry Pi. 


{ast word 


It's not a board for those new 
to hardware projects with 
the Raspberry Pi, but rather 


a board for those with good 
experience with electronics 
and microcontrollers. 
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PIBORG ULTRABORG 


Maker 
says 
Precision 
servo control 
with ultrasonic 
module 


support 
PiBorg 


PIBORG ULTRABORG 


A combined ultrasonic sensor and servo driving board, is the UltraBorg the all-in-one 
add-on which roboticists have been craving? Gareth Halfacree finds out... 
esigned with the Raspberry functionality is controlled through tuning the servo limits as simple 


Piin mind, butcompatible —anon-board PIC chip, which takes as possible, with sliders to adjust 
with any microcomputer or _ the pressure off the Raspberry Pi’s the positions, and buttons to save 


microcontroller that can talk I2C, processor and allows for accurate a Startup position and set max/min 
the UltraBorg is aimed at robotics real-time control. rotation limits; these are saved 
enthusiasts. Built to simplify the to the PIC processor’s EEPROM, 
building of servo-based robots, the Easy to install which survives power cycles. 
Ree diminutive board provides support Installation of the board is The GUI is joined by a basic 
PWM/ for two device types: servos and straightforward using a simple demonstration program, showing 
SERVO HAT ultrasonic sensors. software installation script available sliders for all four servo channels, 
MINI KIT For servos, it provides four from PiBorg’s website, although along with distance reports from 
Providedtasa channels of 16-bit control ona you’ll need to provide your own the four ultrasonic channels. 
simple soldering bank of triple-pin headers on its 5V power supply. The board’s Elsewhere, the included Python 
kit, this Adafruit left. This resolution, provided bya mounting holes are designed to allow examples make it easy for new 
ene Toshiba pulse-width modulation it to be positioned in a variety of users to get started. 
way to interface (PWM) chip and considerably orientations, including sharing the Pi 
with ultrasonic higher than the 12-bit found on A+/B+ and Pi 2’s mounting holes and fast word 
aap cant most rival devices, indicates that piggybacking above to save apave. ihe UliraBore|le a great choles 
PWM devices PiBorg has really thought its design The UltraBorg takes up the first six f F 2 
- including through; this is confirmed by the pins on the GPIO header, leaving at pope re picts ote ld 
servos. oa ce : ate eatures rarely seen on servo 
ability to save a startup DOSIBON, the rest free - and while the fimit of ecrircliboards butts four 
as wellas maximumand minimum just four servos may seem troubling, channalllimitationiovercome 
limits in the controller. it’s possible to daisy-chain multiple through daisy-chaining - 
The ultrasonic portion of the UltraBorgs together to support as means it can get expensive for 
board is, likewise, four-channel, many ultrasonic sensors and servos more complex projects. 
supporting the four-pin modules as your project requires. 
eee = common to most robot kits PiBorg has even thought to 
and hobby supply shops. All include a simple GUI. This makes 
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CAMJAM 
EpuKIT 


Download the EduKit 
worksheets from 
camjam.me/edukit 


CAMJAM EDUKIT 2 


Maker 
says 
The latest 

addition to 

the Edukit 
family! 


CamJam 


Image: Alex Eames. www.RasPi.TV 


AMJAM EDUKIT 2 


A tin full of tinkering kit, for less than a tenner. 
Les Pounder investigates CamJam’s latest box of tricks... 


EXPLORER 
HAT PRO 


Amore 
expensive 
solution than 
the Edukit. 
However, with 
analogue inputs, 
capacitive touch 
sensors, anda 
motor controller 
featuring an H 
Bridge, this is 

a great add-on 
board for many 
project types. 


: “a 
£18 / $22.95 
shop.pimoroni.com 
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he EduKit is a pocket- 

money project box that’s 

compatible with all 
models of Raspberry Pi. Rather 
than produce an add-on board, the 
CamJam team have packaged all 
the components needed to build 
a number of physical computing 
projects into a rather handy tin. 

A follow-up to CamJam’s original 
EduKit, the second edition is entitled 
‘Sensors’ and contains a lot of 
electronic components — enough to 
make six starter projects. In the kit 
you’ ll find LEDs, buzzers, wires, and 
a breadboard — as we did in the first 
EduKit — but there’s also a light- 
dependent resistor (LDR), passive 
infrared sensor (PIR), and a DS18B20 
temperature sensor inside. 


Worksheets 

So what can you make with 
these components? Using the six 
downloadable worksheets, you 
can start by controlling the LED 
and buzzer with some simple 


Python code. The worksheets 
also cover creating an alarm 
based on the PIR sensor, which 
can detect movement; you 

could, for example, trigger a 
sequence of LED flashes and 
buzzer sounds. One of the more 
challenging worksheets uses the 
DS18B20 sensor to read ambient 
temperature, but it can also 

be safely placed into liquid for 
accurate measurements, perhaps a 
great cross-curricular activity for 
introducing the Pi into a science 
lab. Another worksheet focuses 
on the LDR sensor to measure the 
light in a room. Since it produces 
analogue values (something that 
the Raspberry Pi can’t process), 
the EduKit 2 includes a capacitor, 
which will be charged and timed 
using Python code to get the 
readings. The charge time is 
dependent on the flow of energy 
controlled by the LDR, thus giving 
the user an estimated analogue 
value. It’s nicely done. 


Cost-effective 

This kit and its predecessor are 
very cost-effective and well- 
supported starting points for 
anyone interested in getting 
started with the GPIO pins on 

the Raspberry Pi. While there 

are plenty of practical project 
examples included with the kit, 
they can be applied to countless 
other projects and ideas and even 
used with different electronics 
platforms. The accompanying 
online worksheets are excellent 
quality, and provide solid 
instructions that get progressively 
more challenging as you learn. 


{ast word 


Avery high-quality, yet cost- 
effective starting point for 
many physical computing 


projects. An essential purchase 
for home and school learners. 
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BOOKS 


RASPBERRY PI 
BESTSELLERS 


ARM is a far better platform for learning 
assembly language coding than x86 - 
here are the current top three guides... 


RASPBERRY PI 
ASSEMBLY 
LANGUAGE 


Author: Bruce Smith 
Publisher: CreateSpace 
Price: £14.99 

ISBN: 978-1492135289 
tinyurl.com/q6tokqb 


Awell-paced, example-led 
introduction to assembly 
language programming on ARM, 
from the comfort of Raspbian. 
The best beginner's book - but 
read the errata on the website. 


BAKING PI: OPERATING 
SYSTEMS DEVELOPMENT! 


Authors: Alex Chadwick 
Publisher: University of ; a 
Cambridge Computer Lab : 
Price: free online 

ISBN: N/A 
tinyurl.com/k4pd38p 


Popular online course which 
“takes you through the 
basics of operating systems 
development in assembly 
code”, and starts with 
controlling the GPIO pins 
directly. Still mostly works 
on newer Pis. 


ARM SYSTEM 
DEVELOPER'S 
GUIDE 


Authors: Andrew Sloss, 
Dominic Symes & Chris Wright 
Publisher: Morgan Kaufmann 
Price: £57.99 

ISBN: 978-1558608740 
tinyurl.com/mk588lq 


Detailed guide to the ARM 
instruction set, popular among 
embedded ARM developers for 
more than a decade, and still 

a great introduction to writing 
efficient C and assembler code 
for the architecture. 
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RASPBERRY PI FOR 
SECRET AGENTS 
2ND EDITION 


Author: Stefan Sjogelid 
Publisher: Packt 


Price: £15.99 

ISBN: 978-1784397906 5 
tinyurl.com/oknx38x Sec ee 
Many spy film gadgets 


that were once out of 

reach can now be built cheaply with 
a Raspberry Pi. There’s no need for 

a Pi 2 here, but many of the pranks 
rely on a camera and/or microphone, 
while some require a Wi-Fi module, 
GPS, and battery pack. The reason 
for all these accessories? A multitude 
of pranks and secret-agent ways of 
using your Raspberry Pi around the 
home and beyond. 

The first chapter introduces SSH, 
as it’s a lot easier to hide a Pi alone 
than with a monitor. The Audio 
Antics chapter brings in ALSA and 


IF HEMINGWAY 
WROTE 
JAVASCRIPT 


Author: Angus Croll 
Publisher: No Starch 

Price: £13.50 

ISBN: 978-1593275853 
nostarch.com/hemingway 


A valuable 
counterweight to 
the excellent but prescriptive 
Crockford guide to JS [see sidebar 
on next page]. JavaScript is an 
expressive language, but it’s easy 
to forget how far you can push 

the limits until you see a set of 
examples like this. From Joyce to 
Woolf, 25 authors are given new 
voices as putative JS developers 

on five problems — from Fibonacci 
to finding prime numbers — 
separated by poetic interludes. 
Each snippet is both entertaining 
and instructive. While languages 
like Perl are notorious for ‘there’s 
always more than one way to do 

it’ unpredictability, JS has enough 


HEMINGWay 
WROTE 


JAVASCRIPT 


Sound eXchange (SoX), alias, tmux, 
scripting, and scheduling — while 
using the Pi for bugs, calls, and 
voice distortion. Using the camera, 
there’s motion detection and 
capture, plus getting the Pi to 
turn on in the middle of the 
night to scare the unwary. A 
Networking chapter includes 
man-in-the-middle attacks 
and plenty of useful Linux 
info. ‘Taking Your Pi off-road’ 
encompasses battery packs, 
GPS, and data encryption. 

This book of tricks is a great 
driver to learn new skills - after 
all, there are few better motivators 
embedded in the human psyche 
than the desire to wind people up, 
or have a laugh at the expense of 
those near and dear to you. Good 
fun and, like so many Pi books, 
good value too. 


Score 


regularity to cope with someone 
moving the boundaries about. 
As pure entertainment, this is 
a treat to read, but Croll isn’t 
slow to underline the 
persuasive calls of 
different approaches to 
problem solving. 
Complemented 
by Miran Lipovaéa’s 
illustrations, these 
portraits of the artist asa 
coder throw up countless 
gems, from memorable variable 
names to insightful snippets into 
ife and literature. The contrast 
as we leap from Italo Calvino to 
K Rowling is a particular delight, 
but it’s hard to imagine this book 
without any of the 25 entries — even 
Dan Brown. The only downside 
is the way you find yourself, 
after reading other novels, now 
wondering about how each and 
every author would approach 
problems with JavaScript. 


Score 
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LINUX COMMAND 
LINE & SHELL 
SCRIPTING BIBLE 


Author: Richard Blum Zee 
& Christine Bresnahan 5 
Publisher: Wiley 


Price: £33.99 and Shell Scripting 
ISBN: 978-1118983843 Boy 
tinyurl.com/p7hcmgb Jit )| 


Command line 
knowledge isn’t just 
about automating tasks for busy 
Linux systems administrators — a 
deeper Linux understanding will 
enable you to get far more out of 
Raspbian and your Pi. Although 
comprehensive and detailed, this 
guide assumes no prior Linux 
knowledge and explains much 
of what’s happening internally, 
making a useful tutorial, as well as 
reference, for the non-GUI world. 
The first section, on the 
command line, covers similar areas 
to The MagPi’s own command line 
introductory series, but in much 


PROGRAMMING 
ELIXIR 


Author: Dave Thomas 
Publisher: Pragmatic 
Price: £23.99 

ISBN: 978-1937785581 
tinyurl.com/o3r7yrl 


a 


Elixir runs on 

the Erlang VM and is a functional 
programming language that’s 
great for concurrency. It needs a 
more recent Erlang version than 
the one in Raspbian, but installing 
one is easy enough — or SD card 
images are readily available from 
someone who’s already done the 
job. That done, you want a quick 
way to dive in and learn: enter 
Dave ‘Ruby Pickaxe’ Thomas’s 
practical introduction. 

Aimed at existing coders, the 
book dives straight into functional 
programming (“programming 
should be about transforming 
data”) and the power of Elixir’s 


raspberrypi.org/magpi 


Linux Command Line 


greater detail. The remaining 
three sections cover shell scripts 
in progressively greater, then 
more practical, detail. While shell 
scripting will never match 
Python, say, for larger 
programs, here you’ll find 
inspiration for getting 
Raspbian (and other Linux 
systems) to create useful 
utilities, and even to build 
database-driven code that 
interacts with your email 
account and collects web data. 
So it should prove an inspiration as 
well as a useful reference. 
GNU/Linux doesn’t need 
750-page books because it’s 
complicated, but because it’s 
powerful. Very powerful. You can 
live happily with Raspbian without 
knowing three-quarters of what 
Blum and Bresnahan examine here, 
but this is a great collection of Linux 
knowledge when you do need it. 


Score 


concurrency — a benefit of the 
Erlang virtual machine. Elixir’s 
easy syntax, powerful 
macros, and standard library 
will get you up and running 
F so quickly, you may not 
notice that Thomas’s well- 
structured book is carrying 
you so far through the 
learning experience. 

The real strength of this 
work is in shifting how 
you approach coding, teaching 
functional thinking. 

Much shorter than Thomas’s 
famous ‘pickaxe’ book on Ruby, 
it’s about putting the fun back 
into programming, in a world 
of multi-cores and adequate 
RAM, that begs for functional 
programming but without the 
academic trappings. As it says: 
“It?s tomorrow already. 

Are you ready” 


Score 


BOOKS 


ESSENTIAL READING: 


JAVASCRIPT 


The web's own language is powerful and 
eloquent, yet lives in a familiar environment 
(your browser)... 


Eloquent JavaScript 
Second Edition 


Author: Marijn Haverbeke 
Publisher: No Starch 
Price: £26.50 

ISBN: 978-1593275846 
nostarch.com/ejs2 


One of the best introductions to programming 
anywhere, updated for current JavaScript, 
and expanded with projects and more. 


JavaScript & jQuery: Interactive 
Front-end Web Development 
Author: Jon Duckett 

Publisher: Wiley 

Price: £26.99 

ISBN: 978-1118531648 
javascriptbook.com 


JAVASCRIPT 
JQUERY 


Strikingly presented introduction to both 
adding interactivity with JS and speeding 
up your development using jQuery. 


Automate with Grunt: ee 
The Build Tool for JavaScript catewn 
~ Grunt 


Author: Brian P Hogan 
Publisher: Pragmatic 
Price: £11.50 

ISBN: 978-1941222119 fe 
tinyurl.com/nexephh 


The Dusé Toot 
for tnaSerpt ame 


Focused guide to understanding the complete 
JS build environment - use Grunt to convert code, 
run tests, and produce distributions for production. 


Data Visualization 

with JavaScript 

Author: Stephen A Thomas 
Publisher: No Starch 

Price: £26.50 

ISBN: 978-1593276058 
nostarch.com/datavisualization 


a AVATION 
VISUALIZA’ 
WITH JAVASCRIPT 


Communicate! Tree maps, heat maps, ae 
network graphs, word clouds, and even pie 
charts - interactively and in your browser. 


JavaScript: The Good Parts 


Author: Douglas Crockford 
Publisher: O'Reilly 

Price: £19.99 

ISBN: 978-0596517748 
tinyurl.com/3zpqdh5 


Small but dense, and very rewarding, 
but not the first JavaScript book you 
should read. You'll be rethinking your 
entire approach to coding in JS. 
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RASPBERRY JAM 


4 MILWAUKEE RASPI JAM 


@ CACHE VALLEY JAM 


5) SILICON VALLEY JAM 


List your forthcoming events at: 


PARIS PI JAM #2 

When: Wednesday 6 May 

Where: 135 boulevard de Chanzy, 
93100 Montreuil 

meetup.com/Paris-Raspberry-Pi-Jam 

It’s safe to say the first Paris 

Raspberry Jam must have gone 

well, because the second get- 

together is coming soon! 


TORBAY TECH JAM 

When: Saturday 9 May 

Where: Paignton Library, 
Paignton, TQ4 5AG 

torbaytechjam.org.uk 

This monthly tech jam welcomes 

all kinds of hacking and making 

technology (as they all should). 
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A SLICE OF PI CLUB 

When: Tuesday 12 May 

Where: Heart of Worcestershire 
College, Bromsgrove 

sliceofpiclub.wordpress.com 

Another new Raspberry Jam 

event with a focus on having 

fun hacking and making with 

the Raspberry Pi! 


MILWAUKEE RASPI JAM 
When: Wednesday 13 May 
Where: 707 N 11th Street, 

4th Floor, Milwaukee 
bit.ly/1EEU2K2 
Find it at the Kohler Center for 
Entrepreneurship at Marquette 
University. Have fun everyone! 


SILICON VALLEY JAM 

When: Saturday 16 May 

Where: Computer History 
Museum, Mountain View 

bit.ly/1IKPPZ1 

This California-based event 

happens every third Saturday 

of the month at the wonderful 

computerhistory.org museum. 


CACHE VALLEY JAM 

When: Tuesday 19 May 

Where: Wilson Elementary School, 
89 S500 E, Logan, USA 

cachevalleyraspberryjam.com 

The awesome Cache Valley maker 

community will be joined by our 

own Matt Richardson on the day! 
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€) A SLICE OF PI CLUB 


2) TORBAY TECH JAM 


SOUTHEND-ON-SEA 

When: Saturday 30 May 

Where: Tickfield Centre, 

Essex, SSo 7AB 
twitter.com/SouthendRpiJams 
Everyone is welcome to this free 
family tech event focused on coding 
and education. Make sure you book 
your tickets in advance. 


CAMBRIDGE RASPBERRY JAM 

When: Saturday 6 June 

Where: Institute of Astronomy, 
Cambridge, CB3 OHA, UK 

camjam.me 

After a fantastic ‘away’ event, the 

Cambridge Jam returns to its usual 

location for the June gathering. 
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@ SOUTHEND-ON-SEA 


CAMBRIDGE 
RASPBERRY JAM 


DONT MISS: 


When: Saturday 6 June \/here: Cambridge, UK 


For many, the Cambridge Raspberry Jam is the 


highlight of the events calendar. Held at the 


brilliant Institute of Astronomy, its participants 
and organisers have access to a fantastic lecture 
theatre, gd meeting room for workshops, a wide- 
open space for market stalls, and a mezzanine 
level which usually plays host to your community 


creations. Exact details will be posted nearer 


the time, so keep an eye on the event's website. 


camjam.me 


@ PARIS PI JAM #2 


évents 


May 2015 MagPi 


Competition closes 28 May 2015. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Weaved and the 
Power of Pi. 


Add the power 


of lol and mobile 


In 15 minutes. 


LEARN MORE 


Weaved. 
lol Kit 


The Internet of Things for Everyone. 


The Weaved loT Kit for Raspberry Pi gives developers 
the tools they need to transform any Raspberry Pi 
application into an loT application. Here’s what you get: 


Weaved Embedded Cloud Stack 

This super-light, downloadable software package is 
installed on your Pi to communicate with the Weaved 
Cloud Services. 


Weaved Cloud Services 

Weaved operates secure Cloud Services so you can 
incorporate loT features into your Pi project like iOS/ 
Android Push Notifications and remote Mobile Device 
connections to your Pi over the Internet. 


eC 
% Weaved. 


Weaved App for iOS/Android 

Download the Weaved App to create a real loT mobile 
App experience for your Pi project. The Weaved App 
receives standard Push Notifications from your Pi based 
on trigger events you define. Use Weaved to monitor 
and control your Pi from anywhere through a Web GUI 
hosted on your Pi. 


Weaved Developers Portal 

Register as a developer at developer.weaved.com 

to receive full access to our downloadable embedded 
software, documentation, how-to videos and 

sample projects. 


“4 4 Available on the 
Werke® 


Weaved 


©2015 Weaved, Inc. All rights reserved. The Weaved App, ‘The Internet of Things for Everyone,’ Weaved and the Weaved logo are trademarks of Weaved, Inc. All other logos and names are 
trademarks or registered trademarks of their respective companies. Raspberry Pi is a trademark of the Raspberry Pi Foundation. 


341 Hawthorne Avenue, Palo Alto, CA 94301 « Tel 650.262.0320 * www.weaved.com 


Solar Power, Weather 
and Breakout Boards 
— for your Pi and Arduino 


These are really, 


really useful! ams: 
% 


SwitchDoc Labs \s " : 


switchdoclabs.com 


© 2015 SwitchDoc Labs, LLC 


PiConsole 


A clever solution to 
Command Raspberry Pi 
Console from 
your Android or iPhone! 


4 
\ 


OpenElectrons.com 


supplying the full Raspberry Pi range 
of boards and accessories - worldwide. 


Visit RS Components today to view the full range of Raspberry Pi boards and all 
the accessories you may need, including books, cables, data storage, expansion 
boards, operating systems, power supplies, prototyping kits and more. 


Visit RS Online 


NEW Raspberry Pi 2 Rasberry Pi Raspberry Pi Compute Module 


Raspberry Pi 


Model B Model A+ Model B+ Development Kit 
832-6274 833-2699 811-1284 813-4164 


DESIGNSP4 RK Help, hints, and tips and more for your Raspberry Pi | Click Here 


For full pricing and stocking information visit 
www.rs-components.com/raspberrypi 


WANT TO GET 
NOTICED? 


REACH THE RIGHT 
AUDIENCE FAST 


> World’s #1 Pi magazine 

> Block booking discounts 
> Free to download & share 
> Live links on 10S & Android 


The MagPi is the most exciting mag in tech today, boasting 
one of the biggest & most engaged audiences in the industry. 


SUPER-7 EST 


Place On your pj 


C/O 


BUILD A 
ALARM clog OS 


FOR MORE INFO EMAIL RUSSELL@RASPBERRYPI.ORG 


Column THE FINAL WoRD 


MATT RICHARDSON 


Matt is Raspberry Pi’s US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


~RASPBERRY PI 
' AS A MATERIAL 


Full computers have become a common component in projects. 


hen I began working with Raspberry Pi 

in my technology projects, it prompted a 

change in how I view computers. Because of 
the small size and low price of the board, I started 
to think that a computer isn’t strictly a tool, but 
can also be considered a component in a project. 
Just as though I was reaching for resistors, wires, 
and microchips from my workshop component 
bins, I was also starting to reach into a bin of 
computers whenever I needed one. The Raspberry 
Pis in this stash were a material like any other. 

This was an entirely new idea to me, but it 
wasn’t until I came across the work of Seymour 
Papert that I found out that this isn’t anew 
concept at all. 

You might already be familiar with some of 
Seymour Papert’s work. He was part of the team 
that created the Logo programming language, 
which uses a robotic or on-screen ‘turtle’ to move 
and draw according to procedural code. In 1988, 
Papert and George Franz contributed an article to 
the Teachers College Record, entitled ‘Computer as 
Material: Messing About with Time’. 

The article describes a junior high-school science 
lesson in a New York City public school. The 
students watched the teacher repeatedly place an 
empty glass jar over a lit candle to see it extinguish. 
The students were then challenged to measure the 
amount of time it took for the candle to be snuffed 
without the use of watches or clocks. 

With the materials available to them (test tubes, 
pulleys, marbles, microscopes, scrap wood and 
the like) some students built pendulums; others 
used sand to make crude versions of an hourglass. 
Computers with Logo were also available to them, 
just like any of the materials above. 

“When the students let their imaginations go, 
they found a variety of odds and ends for different 
explorations and investigations,” according to 
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Matt Richardson discovers that it’s not a new idea at all 


Papert and Franz. “The computer was just one more 
material, alongside candles, crayons, ammeters, 
and rulers.” 

The students using Logo wrote code to keep time 
in a few different ways, from drawing a second hand 
on screen, to having the computer beep once per 
second. Even better, their timers became extensible 
with the addition of other components. For 
instance, with a light sensor, they could track the 
speed of LEGO cars on aramp to iteratively optimise 
their designs for speed. Or with a temperature 
sensor, they could ensure that their class pet would 
be safe from the cold when the school turned off 
the building’s heating system at night. 


Constructionism 

Papert coined the term ‘constructionism’ to 
describe this method of project-based learning and 
his ideas are being implemented in makerspaces at 
schools and libraries worldwide. As far back as 1971, 
Papert foresaw the computer as a central part of 
educational making. In ‘Twenty Things to Do witha 
Computer’, an MIT AI Lab paper Papert wrote with 
Cynthia Solomon (hdl. handle.net/1721.1/5836), 
they describe a computer system suited for such 
projects, complete with inputs and outputs. 

“In our image of a school computation laboratory, 
an important role is played by numerous ‘controller 
ports’ which allow any student to plug any device 
into the computer,” write Papert and Solomon. 
“The laboratory will have a supply of motors, 
solenoids, relays, sense devices of various kinds, 
etc. Using them, the students will be able to invent 
and build an endless variety of cybernetic systems.” 

When reading Papert’s articles, it’s hard not to 
think of Raspberry Pi as the perfect computer- 
as-material. So don’t be surprised if one day you 
discover a bin for computers next to the bins for 
pipe cleaners and googly eyes. 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 


Breakout Pi Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Pi Plus 


8 channel analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
channels to your Raspberry Pi. 


lO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi. 


RTC Pi Plus 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and |?C address 
selection. 


electronics 


We also stock a wide range of expansion boards 
for the original Raspberry Pi models A and B 


Use a browser from 
any device to program 
and monitor your 
Raspberyy Pi 


Program and monitor Use our graphs to 
your Pi from anywhere display your sensors’ 
in the Intemet data 


www.wyliodrin.com @ python fcr) nedeo 


Just drag & drop blocks 
to create your applica- 
tions, using Visual 
Programming 


CO &® 


ARDUINO 


